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Preface 



About This Course 



Instructional Goals 

Upon completion of this course, you should be able to: 

• Manage file systems 

• Install software 

• Perform system boot procedures 



Perform user and security administration 
Manage network printers and system processes 
Perform system backups and restores 
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Course Map 



Course Map 



The course map enables you to see what you have accomplished and 
where you are going in reference to the instructional goals. 

Managing File Systems 



Introducing 
the Solaris™ 
OE Directory 

Hierarchy 



Managing 
Local Disk 

Devices 



Managing 
the Solaris OE 
File System 



Performing 
Mounts and 
Unmounts 



Installing Software 



installing the 

Solaris™ 9 
OE 



Performing 
Solaris 9 OE 

Package 
Administration 



Managing 
Software 
Patches on 
the Solaris 9 
OE 



Performing System Boot Procedures 



Executing 
Boot PROM 
Commands 



Performing 
Boot and 
Shutdown 

Procedures 



Performing User and Security Administration 





Performing 




User 




Administration 




Managing Network Printers and System Processes 



Configuring 
Printer 
Services 



Using 
Print 
Commands 



Controlling 

System 
Processes 



Performing System Backups and Restores 



Performing 
File System 
Backups 



Performing 
File System 
Restores 



Backing Up 
a Mounted 
File System 
With a UFS 
Snapshot 
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Topics Not Covered 



Topics Not Covered 

This course does not cover the following topics. Many of these topics are 
covered in other courses offered by Sun Educational Services: 

# Basic UNIX® commands - Covered in SA-119: UMX® Essentials 
Featuring the Solaris™ S Operating Environment 

• The vi editor - Covered in SA-119; UNIX® Essentials Featuring the 
Solaris™ 9 Operating Environment 

m Basic UNIX file security - Covered in SA-119: UNIX 9 Essentials 
Featuring the Solaris™ 9 Operating Environment 

m JumpStart™ procedure- Covered in SA-299: Advanced System 
Administration for the Solaris™ 9 Operating Environment 

m Network File System (NFS) environment configuration - Covered in 
SA-299: Advanced System Administration for the Solaris™ 9 Operating 
Environment 

• Naming services - Covered in SA-299: Advanced System 
Administration for the Solaris™ 9 Operating Environment 

* Troubleshooting - Covered in ST- 350: Sun™ Systems Fault Analysis 
Workshop 

* System tuning - Covered in SA-400: Solaris™ System Performance 
Management 

Refer to the Sun Educational Services catalog for specific information and 
registration. 
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How Prepared Are You? 



How Prepared Are You? 

To be sure you are prepared to take this course, can you answer yes to the 
following questions? 

• Perform basic UNIX tasks 

• Understand basic UNIX commands 

• Use the vi text editor 

• Interact with a windowing system 
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Introductions 



Introductions 



Now that you have been introduced to the course, introduce yourself to 
the other students and the instructor, addressing the items shown below: 

Name 

Company affiliation 
Title, function, and job responsibility 
Experience related to topics presented in this course 
Reasons for enrolling in this course 
Expectations for this course 
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How to Use Course Materials 



How to Use Course Materials 

To enable you to succeed in this course, these course materials employ a 
learning module that is composed of the following components: 

• Objectives - You should be able tu accomplish tht j objectives after 
completing a portion of instructional content. Objectiv es support 
goals and can support other higher-level objectives. 

• Lecture - The Instructor will present information specific to the 
objective of the module. This information will help you learn the 
knowledge and skills necessary to succeed with the activities. 

• Activities - The activities take on various forms, such as an exercise, 
self-check, discussion, and demonstration. Activities are used to 
facilitate mastery of an objective. 

• Visual aids - The instructor might use several visual aids to convey a 
concept, such as a process, in a visual form. Vis mil aids commonly 
contain graphics, animation, and video. 



Note - Many system administration tasks for the Solaris' ' M Operating 
Environment can be accomplished in more than one way. The methods 
presented in the courseware reflect recommended practices used by Sim 
Ed u ca ti ona 1 Services* 

■ : 
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Conventions 



Conventions 



The following conventions are used in this course to represent various 
training elements and alternative learning resources. 



Icons 



Discussion - Indicates a small-group or class discussion on the current 
topic is recommended at this time. 



Demonstration - Indicates a demonstration of the current topic is 
recommended at this time. 



Note - Indicates additional information that can help students but is not 
crucial to their understanding of the concept being described. Students 
should be able to understand the concept or complete the task without 
tliis information. Examples of notational information include keyword 
shortcuts and minor system adjustments. 



Caution - Indicates that there is a risk of personal injury from a 
nonelectrical hazard, or risk of irreversible damage to data, software, or 
the operating system, A caution indicates that the possibility of a hazard 
(as opposed to certainty) might happen, depending on the action of the 
user. 
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Conventions 



Typographical Conventions 

Courier is used for the names of commands, files, directories, user 
names, host names, programming code, and on-screen computer output; 
for example: 

Use the Is -al command to list all files. 
hostl# cd /home 

Courier bold is used for characters and numbers that you type; for 
example; 

To list the files in this directory, type the following: 



3 Is 




Courier italics \s used for variables and commandi-lme placeholders 
that are replaced with a real name or value; for example: 

To delete a file, use the mi filename command. 

Courier Italic bold is used to represent variables whose values are to 
be entered by the student as part of an activity; for example: 

Type chmod a*rwx filename lo grant read/ write, and execute 
rights for filename. 



Palatine italics is used for book titles, new words or terms, or words that 
you want to emphasize; for example: 

Read Chapter 6 in the User's Guide. 
These are called class options. 
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Module 1 



Introducing the Solaris™ OE Directory 
Hierarchy" 



Objectives 



Upon completing this module, you should be able to; 

• Describe / (root) subdirectories 

• Describe file components 

• Describe file types 

• Use hard links 



J 



The following course map shows how this module fits into the current 
instructional goal. 

SiliBl lif m mJm %^ tit ^ 

Managing File Systems 



Introducing 
the Solaris™ 
OE Directory 

Hierarchy 



Managing 
Local Disk 
Devices 



Managing 
Ihe Solaris OE 
Rfe System 



Performing 
Mounts and 
Unmounts 



Figure 1-1 Course Map 
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Introducing / (root) Subdirectories 



Introducing / (root) Subdirectories 



The directory hierarchy of the Solaris J M Operating Environment 
(Solaris OE) is organized for administrative convenience. Branches within 
this directory tree segregate directories that are used for different 
purposes. For example, directories exist to hold files that are private to the 
local system, files to share with other systems, and home directories. 

Logically all directories fall below the / (root) directory Physically, 
however, directories can be located on a single file system or divided 
among multiple file systems. Every Solaris OE must have a root file 
system but can also have other file systems attached at points within the 
director}' hierarchy Most file systems are structures created on disk slices 
that contain or hold files and directories. 



No te - Refer to roan -s5 file sys tern for informal ion on fiJ e system 
organization. 
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Introducing Important System Directories 

The Solaris OE consists of a hierarchy of critical system directories and 
files that are necessary for the operating system to function properly. The 
following is a list of some of tire critical system directories and 
subdirectories that are found in the Solaris OE. 



/ The root of the overall file system namespace. 

/bin A symbolic link to the /usr/bin directory, It is the 

directory location for the binary files of standard 
system commands. 

/dev The primary directory for logical device names, The 

contents of this directory are symbolic links that point to 
device fiJes in the /devices director}. 

/devices The primary director}' for physical device names, 

etc The cHrectory that holds host-specific configuration files 

and databases for system administration. 

/ expor t The def a u] t directory for commonly shared file systems , 

such as users' home directories, application software, or 
other shared file systems. 

/home The default directory or mount point for a user's home 

directory 

/kernel The directory of platform-independent loadable kernel 

modules that are required as part of the boot process. 

/mnt A convenient, temporary mount point for file systems. 

/opt The default directory or mount point for add-on 

application packages. 

/platform The directory of platform-dependent loadable kernel 
modules. 

shin The single-user bin directory that contains essential 

executables that are used during the booting process 
and in manual system- failure recovery. 

/trap Tine directory for temporary files. This directory is 

cleared during the boot sequence- 

/usr The directory that contains programs, scripts, and 

libraries that are used by all system users. The direc ton- 
name is an acronym for UNIX® system resources. 

/var The directory for varying files, which usually includes 

temporary, logging, or status files. 
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Introducing / (root) Subdirectories 



The following tables list prima ry subdirectories under key directories, 
Table 1-1 Primary Subdirectories Under the /dev Directory 



Subdirectory 


Description 


/dev/cua 


Dial-out device files for UNlX-to-UNIX Copy 
Protocol (UUCP) and Point- to- Point Protocol 
(PPP) 


/dev/dsk 


Block disk devices 


/ dev/ f bs 


Frame buffer device files 


/dev/fd 


File descriptors 


/dev/md 


Logical volume management met a disk devices 


/dev/pts 


Pseudo terminal devices 


/dev/rdsk 


Raw disk devices 


/dev/rmt 


Raw magnetic tape devices 


/dev/ sound 


Audio device and audio-device control files 


/dev/ term 


Serial devices 


Table 1-2 Primary Subdirectories Under the /etc Directory 


Subdirectory 


Description 


/etc/acct 


Configuration information for the accounting 
system 


/etc/cron.d 


Configuration information for the cron utility 


/etc/ default 


Default information for various programs 


etc. inet 


Configuration fiJes for network services 


/etc/init ,d 


Scripts for starting and stopping services, used 
while changing between run levels 


/etc/lib 


Dynamic linking libraries needed when the 
/usr file system is not available 


/etc/lp 


Configuration information for the printer 
subsystem 


/etc/mail 


Configuration information for the mail 
subsystem 



1 -4 I nte rm ediate Sy ste m Ad m in ist rat i on fo r ft e Solaris ™ 9 Op e rati ng E n vi ron ment 

Copyright 2003 Sun Microsyslenns. Inc. All Rights Reserved, Sun Services. Revision A .2 



Introducing / {root) Subdirectories 



Table 1-2 Primary Subdirectories Under the /etc Directory (Continued) 



Subdirectory 


Di*<;cri oti on 


/etc/nfs 


Configuration file for NTFS server logging 


/'etc /opt 


Configuration information for optional 
packages 


/etc/rc#.d 


Scripts that are when entering or leaving a 
specific run level 


/etc/skel 


Default shell initialization files for new user 
accounts 


Table 1-3 Contents of the /usr Directory 


Subdirectory 


Description 


/usr /bin 


Standard system commands 


/usr/ccs 


C-compilation programs and libraries 


/usr /demo 


Demonstration programs and data 


/usr/dt 


Directory or mount point for Common Desktop 
Environment (CDE) software 


/usr/ include 


Header files { for C programs, and so on) 


/usr/java 


Directories that contain Java™ technology 
programs and libraries 


/usr/kernel 


Platform- independent loadable kernel 
modules that are not generally required during 
the boot process 


/usr/ lib 


Architecture-dependent databases, various 
program libraries, and binaries that are not 
invoked directly by the user 


/usr/opt 


Configuration information for optional 
packages 


/usr/sbin 


System administration commands 


/usr /spool 


Symbolic link to the /var/ spool directory 
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Introducing File Components 



All files in th e Solaris OE make use of a file name and a record called an 
inode. Most files also make use of data blocks, In general, a file name is 
associated with an inode, and an inode provides access to data blocks, 



Figure 1-2 shows the relationship between the file components, 



File Name 
Inode Number 





Figure 1-2 File Names, Inodes, and Data Blocks 



File Names 



File names are the objects most often used to access and manipulate files. 
A file must have a name that is associated with an inode. 



Inodes 



modes are the objects the Solans OE uses to record information about a 
file. In general, inodes contain two parts. First, inodes contain information 
about the file, including its owner, its permissions, and its size* Second, 
inodes contain pointers to data blocks associated with the fUe. 

Inodes are numbered, and each file system contains its own list of inodes. 
When a new file system is created, a complete list of new inodes is also 
created in that file system. 
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Introducing File Components 



Data Blocks 

Data blocks are units of disk space that are used to store data. Regular 
files, directories, and symbolic links make use of data blocks. Device files 
do not hold data, 
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Identifying File Types 

The Solaris OE supports a standard set of file types that are found in 
nearly all UNIX-based operating systems. In general, files provide a 
means of storing data, activating devices, or allowing inter-process 
communication. Of die different types of files that exist in the Solaris OE, 
there are four main file types: 

• Regular or ordinary files 

• Directories 

• Symbolic links 

• Device files 

Regular files, directories, and symbolic links all store one or more types of 
data. Device files do not store data, Instead, device files provide access to 
devices. 




Use the Is command to distinguish different file types from one another, 
The character in the first column of information that the Is -1 command 
displays indicates the file type. 

The following examples, taken from a SPARC® technology Ultra m 5 
workstation, show partial listings of directories that contain a variety of 
different file types: 



$ cd /etc 
# Is -1 

total 428 

drwxr-xr-x 2 adm adm 
lrwxrwxrwx 1 root root 
. /mail /aliases 
drwxr-xr-x 2 root bin 

-rw-r— r— 1 root bin 
-rw-r — r-- 1 root bin 
(output truncated) 



...... 















512 


Apr 


3 


10: 


:42 


acct 


14 


Apr 


3 


11: 


1 05 


aliases -> 


512 


Apr 


2 


10: 


:45 


apache 


50 


Apr 


3 


10: 


:45 


auto _home 


113 


Apr 


3 


10: 


:45 


auto_jnaster 



* cd /devices /pci<?lf, Q/pci@l, l/ide@3 
ft Is -1 

total 0 



brw 


1 


root 


sys 


136, 


0 


Apr 


a 


11: 


:11 


dad@0, 0:a 


crw-- 


i 


root 


sys 


136, 


0 


Apr 


3 


11: 


:11 


dad@0, 0 : a, raw 


brw 


i 


root 


sys 


136, 


1 


Apr 


■■; 


11: 


:06 


dadGO, 0:b 


crw 


i 


root 


sys 


136, 


1 


Apr 


3 


11: 


:11 


dad@G, 0 :b, raw 



(output truncated) 
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Identifying File Types 



The character in the first column identifies each Hie type, as follows: 

Regular files 
d Directories 
1 Symbolic links 



Perhaps the most common file types found in the Solaris OE are regular 
files, which enable the user to store many different types of data. Regular 
files can hold American Standard Code for Info rmanon Interchange 
(ASCII) text or binary data, including image data, database data, 
a ppli ca ti on -rel ated data , and mor e. 

w i& silk tnHi i ^ft- ' < *ft^ 

There are many ways to create regular files. For example, a user could use 
the vi editor to create an ASCII text file, or a user could use a compiler to 
create a file that contains binary data. As another example, a user could 
use the touch command with a nonexistent file name to create a new, 
empty regular file, 



b 



c 



Block-special device files 
Character-special device files 



Regular Files 
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Identifying File Types 



Figure 1-3 shows a regular file called f ilel. As illustrated, the name 
file! is associated with inode number 1282. The data blocks associated 
with f ilel cart hold one of many types of data, and the file could have 
been created in one of many different ways. 

filel 
Inode 1282 



Data 

Text 

Binary data 
images 

Application data 
Databases 




Creation Methods 

Text editors 
Compilers 

Application programs 
Database programs 
Commands (for example, touch) 



Figure 1-3 Regular Files 

Directories 



Purpose 

Regular f ties store data 



Directories store information that associates file names with inode 
numbers. Unlike regular files, which can hold many different types of 
data, directories only hold file name-to-inode associations. 

A directory contains entries for files of all types that are logically found 
within that directory. 
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Identifying File Types 



Figure 1-4 shows information about a directory called dirl. As illustrated 
in the figure, the name dirl is associated with inode number 4221, The 
data blocks associated with the dirl directory hold a list of file names 
and their associated inode numbers, The mkdir command is one way to 
create new directories. 



dirl 

Inode 4221 



Data 

Directory 
information 



Data Blocks 

filel a Inode 1282 
dirA= Inode 5314 



Creation Methods 



lakdir name 




Purpose 



Directories store data that 
associates file names with 
inode numbers. 



Figure 1-4 Directories 



Think of the information that directories hold as a list. Each entry in this 
list accounts for one fiJe name, If the file called f ilel and the directory 
called dirA were logically located in the directory called dirl, then the 
dirl directory would contain an entry that associates the name file! 
with inode number 1282 and an entry that associates the name dirA with 
inode number 5314. 



Symbolic Links 

A symbolic link is a file that points to another file. Like directories, which 
contain only directory information, symbolic links contain only one type 
of data- 

A symbolic link contains the path name of the file to which it points, 
Because symbolic links use path names to point to other files, they can 
point to files in other file systems. 

The size of a symbolic link always matches the number of characters in 
the path name it contains. 
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Identifying File Types 



In the following example, the symbolic link called /bin points to the 
directory . /usr/bin. The size of the symbolic link is 9 bytes because the 
path name . /usr/bin contains nine characters. 

# cd / 

# Is -1 bin 

total 135 

lrwxrwxrwx 1 root root 9 Mar 22 10:39 bin ~> ./usr/bin 



Symbolic links can point to regular files, directories, other symbolic links, 
and device files. They can use absolute or relative path names. 



The In command with the option creates a symbolic link, 
# In -s filel linkl 

Symbolic links direct read and write operations to the file to which they 
point. The preceding command shows how using linkl as a command - 
line argument causes the in command to refer to the file called filel. 



Figure 1-5 shows a symbolic link file called linkl. As shown in the 
following figure, the linkl file is associated with inode number 356 L The 
data block for the linkl file contains the path name ( . / filel) to filel. 

linkl filel, 
Inode 3561 X Inode 1282 



Data 

Single 
path name 



Purpose 
Figure 1-5 Svmbolic Links 




Intermediate System Administration for the Solaris™ 9 Operating Environment 
Copyright 2003 Sun Microsystems. Inc. All Rights Reserved. Sun Services. Revision A.2 



Identifying File Types 



Device Files 



A device file provides access to a device. Unlike regular files, directories, 
and symbolic links, device files do not use data blocks. Instead, the inode 
information of device files holds numbers that refer to devices. Use the 
Is -1 command to display these numbers. 



For example, a long listing of a regular file shows the file's size. 



# cd /etc 
















# Is -al |more 














total 510 
















drwxr-xr-x 


51 root 


sys 


3584 


Mar 


14 


07 :35 




drwxr-xr-x 


2B root 


root 


1024 


Mar 


14 


07 :30 




drwxr-xr-x 


2 adfri 


adm 


512 


Feb 


13: 


12 : 15 


acct 


Irwxrwxrwx 


1 root 


root 


14 


Feb 


13 


10:27 


aliases -> 


. /mail/alia 


ses 














drwxr-xr-x 


3 root 


bin 


512 


Feb 


13 


12 :15 


apache 


~rw-r--r — 


1 root 


bin 




Feb 


13 


1 0 ; 4 0 


auto_home 


-rw-r— r — 


1 root 


bin 


113 


Feb 


13 


10:40 


auto_master 


Irwxrwxrwx 


1 root 


root 


16 


Feb 


13 


10:26 


aut opus h -> 


. . /sbin/ aut opus h 














dr-xr-xr-x 


3 root 


root 


512 


Feb 


28 


14:07 


certs 


Irwxrwxrwx 


1 root 


root 


18 


Feb 


13 


10:26 


cfgadm -> 


. . / us r / sbin / c f gadm 














Irwxrwxrwx 


1 root 


root 


18 


Feb 


13 


10:35 


chroot -> 


. . /usr/sbin/chroot 














lrwxxwtrwx 


1 roots : 


root 


16 


Feb 


13 


10:26 


clri 


. ♦ /usr/sbin/clri 














-rw-r — r — 


1 root 


. other 


314 


Mar 


14 


07:06 


coreadm . conf 


-rw-r — r — 


1 root" 


xoot 


2236 


Mar 


14 


07:06 


. cpr_conf ig 


Irwxrwxrwx 


1 root 


root 


16 


Feb 


13 


10:26 


cron -> 


. - / usr / sbin / cron 


mm 












{output truncated) 















A long listing of a device file shows two numbers, separated by a comma. 
These two numbers are called major and minor device numbers. In the 
following example, the device file dad@0 ,0:a refers to major device 
number 136 and minor device number 0, 

# cd /devices /pci@lf , 0 /pci@l , 1 / ide@3 

# Is -1 dadeo* 

total 0 

brw-r 1 root sys 136, 0 Sep 6 15:40 dad@0,0:a 

crw-r 1 root sys 136, 0 Sep 6 15:40 dad(30, 0:a,raw 

brw-r 1 root sys 136, 1 Sep 7 07:37 dad@0,0:b 
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crw-r 


1 


root 


sys 


136, 


1 


Sep 


6 


15:40 


dad@0, 0:b,raw 


brw-r 


1 


root 


sys 


136, 


2 


Sep 


6 


15:40 


dad@Q,G:c 


crw-r 


1 


root 


sys 


136, 


2 


Sep 


6 


15:40 


dad@0, 0:c,raw 


brw-r 


1 


root 


sys 


136, 


3 


Sep 


6 


15:40 


dad@0 , 0 : d 


crw-r 


1 


root 


sys 


136, 


3 


Sep 


6 


15:40 


dad@0,0:d,raw 


brw-r 


1 


root 


sys 


136, 


4 


Sep 


6 


15:40 


dad@0,0:e 


crw-r 


1 


root 


sys 


136, 


4 


Sep 


6 


15:40 


dad@0, 0:e,raw 


brw-r 


1 


root 


sys 


136, 


5 


Sep 


6 


15:40 


dad£0,0:f 


crw-r 


- 1 


root 


sys 


136, 


5 


Sep 


6 


15:40 


dad@0,0:f ,raw 


brw-r 


1 


root 


sys 


136 P 


G 


Sep 


6 


15:40 


dad@0,0:g 


crw-r 


1 


root 


sys 


136, 


6 


Sep 


6 


15:40 


dad@0, 0:g,raw 


brw-r 


- 1 


root 


sys 


136, 


7 


Sep 


■5 


15:40 


dad@0,0:h 


crw-r 


1 


root 


sys 


136, 


7 


Sep 


6 


15:40 


dad@0, 0:h,raw 



A major device number identifies the specific device driver required to 
access a device. A minor device number identifies the specific unit of the 
type that the device driver controls. 



The device file dad@Q, 0 :a, shown in Figure 1-6, -occupies inode number 
90681. The inode contains the major and minor device numbers that refer 
to a specific device, in this case, a slice on a disk. 




Major ancf minor 
device number? 



Creation Methods 



dflvf sadm (Solaris B and Solaris 9 OE) 
drvco&Eio (Solaris 2 through Solans 7 OE) 



Purpose 

Device tiles provide access to devices. 
Their major and minor device numbers 
refer to specific device drivers and 
individual devices. 



Figure 1-6 Device Files 

In genera], a reconfiguration boot creates device files and symbolic links 
to the device files automatically. In both the Solaris 8 OE and Solaris 9 OE, 
you can use the devf sadm command to create new device files manually. 
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A direct relationship exists between the device hie and the device it 
controls. The major and minor device numbers contained in the in ode 
establish this relationship. 

Figure 1-7 shows the relationship between the device file dad@Q r 0 : a and 
the disk device it controls. The inode information for dad@0 , 0 :a contains 
major number 136 and minor number 0, Major number 136 identifies the 
dad device driver, The dad device driver controls integrated device 
electronics (IDE) disk drives. Minor number 0, in this case, identifies 
Slice n. 

Device File 



dad<iO p O:a 

1 kernel Modules Disk Device 




Figure 1-7 Device File Example 



Device files fall into two categories: character-special devices and 
block-special devices. Character-special devices are also called character 
or raw deuces. Block-special devices are often called block devices. 
Device files in these two categories interact with devices different! \\ 



Character-Special Device Files 

The file type "c" identifies character-special device flies* For disk devices, 
character-special device files call for input /output (I/O) operations based 
on the disk's smallest addressable unit, a sector. Each sector is 512 bytes in 
size. 

The following example shows a character-special device file, 
crw-r 1 root sys 136, 0 Feb 14 11:05 dad@0, 0 :a, raw 
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Block-Special Device Files 

The file type "b" Identifies block-special device files. For disk devices, 
block-special device files call for I/O operations based on a defined block 
size* The block size depends on the particular device, but for UNIX file 
systems (uf s), the default block size is 8 Kbytes. 

I he following example shows a block-special device file, 

brw-r 1 root sys 136, 0 Feb 14 11:05 dad@0,0:a 
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Using Hard Links 

This section defines hard links and describes how to use them, 



Introducing Hard Links 



A hard link is the association between a file name and an inode. A hard 
link is not a separate type of file. Every type of file uses at least one hard 
link, Every entry in a directory constitutes a hard link, TTiink of every file 
name as a hard link to an inode. When you create a file, using the touch 
command, for example, a new directory entry is created that links the file 
name you specified with a particular inode. In this way, creating a new 
file creates a hard link. 

!. ' ■ . . 

In Figure 1-8, the file called f ilel is listed in the directory dirL In dirl, 
the name f ilel is associated with inode number 1282, The hard link is 
the association between f ilel and inode number 1282. 





H filel = lr>ode 1282 

•1 W 



Figure 1-8 Hard Link 



Information in each inode keeps count of die number of file names 
associated with it. This is called a link count. In the output from the 
Is - 1 command, the link count appears between the column of file 
permissions and the column identifying the owner. In the following 
example, the file called filel uses one hard link. 

# ca dirl 

# touch filel 

# Is -1 

total 0 

-rw-r — r — 1 root other 0 Apr 7 15:26 filel 
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Creating New Hard Links 



A new hard link for a file name increments the link count in the 
associated Inode* 

In the following example, inode 1282 now has two hard links, one for 
file! and the other for file2. The Is -li command lists the inode 
number in the left-most column* The find -inum command locates files 
and directories that have the same inode numbers. 



I In filel fil©2 

# IB -1 

total 0 

-rw-r — r — 2 root 
-rw-r — r — 2 root 

# Is -11 
total 0 

1282 -rw-r--r — 
1282 -rw-r— r~ 

# find - -inum 1282 
./filel 

,/file2 



other 
other 



root 
root 



0 Apr 
0 Apr 



7 15:26 filel 
7 15:26 file2 



other 
other 



0 Apr 
0 Apr 



7 15:26 
M: 15:26 



filel 
file2 



The In command creates new hard links to regular tiles. 

For example, the In filel f ile2 command creates a new directory 
entry called f ile2. The £ile2 file is associated with the same inode that 
is associated with filel, 

Figure 1*9 shows the result of the In command* Two file names are 
associated with inode number 1282. Unlike symbolic links, hard links 
cannot span file systems. 



filel 
£ile2 
' Inode 1282 



dirl 
Inode 4221 



Daia Blocks 



Data Blocks 



t ilei 



■- Inode 1282 
i Inode 1282 



Figure 1-9 File Names Associated With an Inode Number 
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Removing Hard Links 

Deleting one of the files has no effect on the other file. The link count 
decrements accordingly. 

The following example shows how deleting file! from the previous 
example has no effect on f ile2. 

# xm filel 
N is -li 

total 0 

1282 -rw-r--r-- 1 root other 0 Apr 7 15:26 file2 
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Performing the Exercises 

You have the option to complete any one of three versions of a lab. To 
decide which to choose, consult the /olio wing descriptions of the levels: 

• Level 1 - This version of the iab provides the least amount of 
guidance. Each buUeted paragraph provides a task description, but 
you must determine your own way of accomplishing each task. 

• Level 2 - This version of the Jab provides more guidance, Although 
each step describes what you should do, you must determine which 
commands (and options) to input. 

• Level 3 - This version of the lab is the easiest to accomplish because 
each step provides exactly what you should input to the system. This 
level also includes the task solutions for all three levels. 
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Exercise: Identifying File Types {Level 1 ) 

In this exercise, you complete the folio wing tasks: 

• Navigate within the directory hierarchy 

• Identify different types of files 



Preparation 



Refer to the lecture notes as necessary to perform the following steps and 
answer the following questions. 



Tasks 



Complete the following tasks: 

m Identify the first symbolic link listed in the / (root) directory Record 
the symbolic link's size and the name of the file it references. Identify 
the types of files found in the/dev/dsk directory and the types of 
files that the symbolic links reference, if any Identify the types of 
files found in the /dev/pts directory and the types of files that the 
symbolic links reference, if any. 

(Steps 1-5 in Level 2 lab) 

V:: [dentify the types of files found in the /etc/init . d directory. 

Record the inode number and link count for the nfs .server file, 
Use the find command to locate all other files below the /etc 
directory that use the same inode as nf s . server. 

(Steps 6-8 in Level 2 lab) 

• Create a directory called /testdir. Ln this directory create a file and 
a symbolic link that points to the file. Determine if the two files use 
the same or a different inode. 

Create a directory called newdir within the / testdir directory, 
Identify the inode it uses, its link count, and the name of any other 
file that uses the same inode as the newdir directory. 

Create another directory below the newdir directory, Determine how T 
the link count for the newdir director}' changes, and find any new 
file that uses the same inode as the newdir directory. 

(Steps 9-14 in Level 2 lab) 
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Exercise: Identifying File Types (Level 2) 



In this exercise, you complete the following tasks: 

• Navigate within the directory hierarchy 

# Identify different types of files 



Preparation 



Refer to the lecture notes as necessary to perform the f oil owing steps and 
answer the following questions, 



Complete the following, .tasks: 

• Identify the first symbolic link listed in the / (root) directory. Record 
the symbolic link's size and the name of the file it references. Identify 
the types of files found in the/dev/dsk directory and the types of 
files that the symbolic links reference, if any. Identify the types of 
files found in the / dev/pts directory and the types of files that the 
symbolic links reference, if any 

• Identify the types of files found in the / etc / init . d directory. 
Record the inode number and link count for the nfs . server file. 
Use the find command to locate all other files below the /etc 
directory that use the same inode as nfs .server. 

• Create a directory called /test dir. In this directory, create a file and 
a symbolic link that points to the file, Determine if the two files use 
the same or a different inode. 

Create a directory called newdir within the /testdir directory. 
Identify the inode it uses, its link count, and the name of any other 
file that uses the same inode as the newdir directory- 
Create another directory below the newdir directory. Determine how 
the link count for the newdir directory changes, and find any new 
file that uses the same inode as the newdir directory 



Task Summary 



... 
■ • 
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Tasks 

Complete the following steps: 

1. Log in as the root user, and open a terminal window. In the / (root) 
directory, perform a long listing and record the name of the first 
symbolic link listed. 

2. What is the size in bytes of the link you found in Step 1? How many 
characters are there in the name of the file to which this link points? 

3. Change to the /dev/dsk directory Record the file types that you find 
in this directory'. 

4. Use the appropriate options for the Is command to display 
information for the files that are referenced by the files in the 
/dev/dsk directory. Recoal the file types reported. 

5. Change to the /dev/pts directory, and use the same commands you 
used in Steps 3 and 4 for the /dev/dsk directory Record the file 
types you find. 

6. Change to the /etfc/init vd directory, and identify the type of file in 
this directory. 

7. How many hard links are associated with the 
/etc/init .d/nfsVserver file? What is the inode number 
associated with this file? 

8. Find the number of files in the /etc directory or below that have the 
same inode number as that used by the /etc/init ,d/n£s . server 
file 

9. Create a new director}'' called /testdir* Create a file in this directory 
called f ilel, Create a symbolic link called linkl that points to 
filel. 

10. List filel and the linkl symbolic link. Do these files use the same 
or different inodes? 

11. In the /testdir directory, create a new directory called newdir. 
What is the number of hard links associated with the newdir 
directory? What is the inode number associated with the newdir 
director}'? 

12. List all files, including hidden files, that exist in the newdir 
directory. Which of these files uses the same inode as the newdir 
directory? 



Introducing the Solaris™ OE Directory Hierarchy 

Copyright 2003 Sun Microsystems. Inc, All Aigh!s Reserved Sun Services, Revision A.2 



1-23 



Exercise: Identifying File Types (Level 2) 



13. Create a new directory called dir2 below the newdir directory. What 
happens to the link count for the newdir directory? 

14. Use the Is command with appropriate options to find the new file 
name that uses the same inode as the newdir directory. Record the 
name of the new file. 
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Exercise; Identifying File Types (Level 3) 

In this exercise, you complete the following tasks: 

• Navigate within the directory hierarchy 

• Identify different types of files 

Preparation 

Refer to the Lecture notes as necessary to perform the following steps and 
answer the following questions. 



Task Summary 




In this twrrise, you accompli sin the following: 

• Identify the first symbolic link listed in the / (root) directory. Record 
the symbolic link's size and the name of the file it references. Identify 
the types of files found inthe/dev/dsk directory and the types of 
files that the symbolic links reference, if any Identify the types of 
files found in the 7dev7pts directory and the types of files mat the 
symbolic links reference, if any. 

• Identify the types of files found in the /etc/init .d directory. 
Record the mode number and link count for the nf s . server file. 
Use the find command to locate all other files below the /etc 
directory that use the same mode as nf s . server. 

• Create a directory called / testdir. In this directory, create a file and 
a symbolic link that points to the file. Determine if the two files use 
the same or a different mode. 

Create a director)' called newdir within the / 'testdir directory. 
Identify the inode it uses, its link count, and die name of any other 
file that uses the same inode as the newdir directory 

Create another directory below the newdir directory. Determine how 
the link count for the newdir directory changes, and find any new 
file that uses the same inode as the newdir directory 
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Tasks and Solutions 



Is -1 



Complete the following steps: 

L Log in as the rooz user, ajid open a terminal window. In the , (root) 
directory perform a lon£ listing, and record the name of the first 
symbolic link listed. 



The /bin symbolic link should be the first link listed in the / (root) 
directory. 

What is the size in bytes of the link you found in Step 1? How many 
characters are there in the name of the file to which this link points? 

The /bin symbolic link con tains 9 bytes of data and points to . /usr/bin. 

Change to the /dev/dsk directory Record the file types that you find 
in this directory. 



# 1© -1 



P Is -1L 



5, 



# cd /derv/pts 

# Is -1 

# Is -1L 



f cd /etc/init.d 



•• •• •• 



Tk 



/dev/dsk directory contains symbolic links. 

Use the appropriate options of the Is command to display 
information for the files referenced by the files in the /dev/dsk 
directory Record the file types reported. 

The symbolic links in the /dev/dsk directory point to block-special device 
file,. 

Change to the /dev/pts director}', and use the same commands you 
used in Steps 3 and 4 for the / dev/dsk directory. Record the file 
types you find. 



The /dev/pts director}/ contains symbolic links. 

The symbolic links in the /dev/pts directory point to character-special 
device files. 

Change to the /etc /init .d directory, and identify' the type of file in 
this directory 

; Is -1 

The /etc/ init, d directory contains regular files. 
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How manv hard links are associated with the 

/ etc/ ini t , d/nf s . server file? What is the inode number 

associated with this file? 



# Is -li nfe. server 



The /etc/ init. d/nf s .server file has six hard links associated with it. 
The inode number varies among different systems, 

Find the number of files in the /etc director)' or below that have the 
same inode number as that used bv the / etc/ ini t. d/nf s . server 
file. 



# Is -i /etc/ ini t. d/nf s .server 

176603 / etc/ init. d/nf s. server 

# find /etc -inum 176603 



Six files, including nf s . server, use the smite inode number. They are: 

/ etc / init . d/nf s . server 
/etc /rcO . d/K2 8nf s . server 
/etc/rcl .d/K28nf s. server 
/ etc /rc2 . d/K28nfs , server 
/ etc/rc3 , d/ SISnfs . server 
/etc/rcS.d/K28nf s -server 



9. Create a new director}' called / testdir. Create a file in this directory 
called filel. Create a symbolic link called link! that points to 
filel. 

# mkdir /testdir 

# cd /testdir 

# touch filel 

# In -s filel linkl 

10. List filel and the linkl symbolic link. Do these files use the same 
or different modes? 




# Is -li 



U : 



11, 



# mkdir newdir 

# Is -Idi newdir 



These two files use two different modes. 

In the /testdir directory, create a new directory called newdir. 
What is the number of hard links associated with the newdir 
directory? What is the inode number associated with the newdir 
directory? 



The link count for the newdir directory is two. Vie inode number varies 
mnong different systems. 
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12, List all files, including hidden files, that exist in the newdir 
directory. Which of these files uses the same inode as the newdir 
directory? 

# Is -lia newdir 

The file culled dot { . } uses the smite inode as the newdir directory, 

13, Create a new directory called dir2 below the newdir directory. What 
happens to the Link count for the newdir directory? 

# mk&ir newdir /dir 2 

# Is -ldi newdir 

The link count increases from two to three. 

14, Use the Is command with appropriate options to find the new file 
name that uses the same [node as [lie newdir directory. Record Lhe 
name of the new file, 

# Is -I&Ri newdir 

The newdir/ dir 2/ . . file uses the same inode as the newdir directory. 
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Exercise Summary 

Discussion - Take a few minutes to discuss what experiences, issues, or 
discoveries you had during the Lih exercise. 

• Experiences 

• Interpretations 

• Conclusions 

• Applications 
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Managing Local Disk Devices 



Objectives 



Upon completion of this module, you should be able to: 
Describe the basic architecture of a disk 
Describe the naming conventions for devices 
List devices 
Reconfigure devices 
Perform hard disk parti Honing 
Manage disk labels 

Describe the Solaris Management Console 
Partition a disk by using the Solaris Management Console 



The following course map shows how this module fits into the current 
instructional goal 



Introducing 
the Solaris™ 
0£ Directory 

Hierarchy 



Managing File Systems 



Managing 
Local Disk 
Devices 



Managing 
!he Solaris OE 
Fife System 



Performing 
Mounts and 
Unmounts 



Figure 2-1 Course Map 
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Introducing the Basic Architecture of a Disk 

A disk device has physical components and logical components. The 
physical components include disk platters and read /write heads, The 
logical components include disk slices, cylinders, tracks, and sectors. 

Physical Disk Structure 

A disk is physically composed of a series of flat, magnetically coated 
platters that are stacked on a spindle. The spindle turns while the 
read /write heads move as a single unit radially, reading and writing data 
on the platters. 




Figure 2-2 Components of a Disk 
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The following list describes the physical components of a disk: 

• The disk storage area is composed of one or more platters. 

• The platters rotate. 

• The head actuator arm moves the read /write heads as a unit 
radially. 

• The read/write heads read and write data on the magnetic surface 
on both sides of the platters- 



Data Organization on Disk Platters 

Figure 2-3 shows the logical components of a disk platter. 





Sector 



Trie smallest addressable unit on a platter 
One sector can hold 512 bytes of data. 
Sectors are also known as disk blocks. 



Track 



A series of sectors positioned end-to-end in 
a circular path. The number of sectors per 
track varies with the radius of a track on 
the platter. The outer tracks are larger and 
can hold more sectors than the Inner tracks. 



Cylinde 



A stack of concentric tracks. 



Figure 2-3 Data Organization on Disk Platters 
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Introducing the Basic Architecture of a Disk 



A disk platter is divided into sectors, tracks, and cylinders. 

Sector The smallest addressable unit on a platter. One sector 

can hold 512 bytes of data. Sectors are also known as 
disk blocks, 

Track A series of sectors positioned end-to-end in a circular 

path, 

Cylinder A stack of tracks. 

The number of sectors per track varies with the radius of a track on the 
platter. The outermost tracks are larger and can hold more sectors than the 
inner tracks. 

Because a disk spins continuously and the read /write heads move as a 
single unit the most efficient seeking occurs when the sectors to be read 
from or written to are located in a single cylinder, 



Disk Slices 





Disks are logically divided into individual partitions known as disk slices. 
Disk slices are groupings of cylinders that are commonly used to organize 
data bv function. 

For example, one slice can store critical system files and programs while 
another slice on fhe same disk can store user-created files. 

Note - Grouping cylinders into slices is done to organize data, facilitate 
backups, and provide swap space. 

A disk under the Solaris OE can be divided into eight slices that are 
labeled Slice 0 through Slice 7. 

By convention, Slice 2 represents the entire disk. Slice 2 maintains 
important data about the entire disk, such as the size of the actual disk 
and the total number of cylinders available for the storage of files and 
directories. 
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A starting cylinder and an ending cylinder define each slice. These 
cylinder boundaries determine the size of a slice. 

Figure 2-4 shows how disk slices might reside on a disk, 

( Slice 0 ^ 

Offset cylinders: 0-2520 

Size: 2521 cylinders 
L . ) 

f Slice 1 ~^ 

Offset cylinders: 2521-2840 

Size: 320 cylinders 
« / 



f Slice 6 




Offset cylinders: 2841- 
Size: 6051 cylinders 
v 


8891 

j 




Figure 2-4 Cylinders and Slices 
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Introducing the Basic Architecture of a Disk 



Table 2-1 shows disk slices and the different file systems they could hold. 
Table 2-1 Disk Slices 



Slice 


Name 


Function 


0 




The root directory's system files 


1 


swap 


Swap area 


2 




Entire disk 


5 


/opt 


Optional software 


6 


/usr 


System executables and programs 


7 


/export /home 


User files and directories 
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Introducing the Basic Architecture of a Disk 



Figure 2-5 shows a possible configuration convention for organizing data. 
The example disk is divided into slices that logically organize the data on 
the boot disk. 




' Slice/ 


V 


The entire disk 






J 



Figure 2-5 Top View of Five Configured Disk Slices 
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Introducing the Basic Architecture of a Disk 



Disk Slice Naming Convention 

An eight-character string typically represents the full name of a slice. The 
string includes the controller number, the target number, the disk number, 
and the slice number. 



Controller number 



Target number 



Disk number 



Slice number 



Identifies the host bus adapter {HBA) f which 
controls communications between the system and 
disk unit. The HBA takes care of sending and 
receiving both commands and data to the device* 
Tile controller number is assigned in sequential 
order, such as cO, cl, c2 , and so on. 

Target numbers, such as tO, tl, £2, and t3, 
correspond to a unique hardware address that is 
assigned to each disk, tape, or CD-ROM. Some 
external disk drives have an address switch 
located on the rear panel. Some internal disks have 
address pins that are jumpered to assign mat 
d i sk* s target number. 

The disk number is also known as the logical unit 
number (LUN), This number reflects the number 
of disks at the target location. 

A slice number ranging from 0 to 7. 



mm &, w * 
% Jr I ^ 
Hie embedded SCSI configuration and the integrated device electronics 

(IDE) configuration represent the disk slice naming conventions across 
two different architectures. The disk number is always set to dO with 
embedded SCSI disks. 



Figure 2-6 shows the eight-character string that represents die full name of 
a disk slice, 

A slice name is an eight-character string: |C $E jt n^Cl jfe S t| 



Controller number 



Target number 



Disk number 



Slice number 



Figure 2-6 Disk Slice Naming Conventions 
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Figure 2-7 shows the configuration of the SCSI architecture- 



System Board 




SCSI 
Target ContfoSter 



Slice 0 = c0tDdGsO 
Slicel = c0tOd£Jsl 



Slice 5 = c0tM0s5 
Slice 6 = c0tid6s€ 



Slice 0=cPt6dQB0 
Siice6 = c0t6d0a6 



Figure 2-7 Embedded SCSI Configuration 

Figure 2-8 shows the configuration of the IDE architecture. 

Primary 



Master 



Slice 0 




System Board 



Master 



Slave 



Slice 0 



t2 




Slice 0 



t3 




Slice 0 = c0t2d0s0 



Slice 0 = cDt3dDsO 



Figure 2-8 IDE Configuration 
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Introducing the Basic Architecture of a Disk 



New I/O boards include on-board gigabit interface converter (GBIC) 
sockets that support the 100 Mbytes per second Fibre Channel Arbitrated 
Loop ( FC- AL) connectivity. FC-AL typically uses glass fibre passing a 
light amplification of stimulated emission of radiation (laser) beam signals 
modulated with information. FC-AL can also use conventional electrical 
(copper) connections, such as a wire cable or backplane. These interfaces 
are typically found on Sun™ Enterprise-level servers. Naming 
conventions appear basically the same to the user. 





.... 
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Introducing Solaris OE Device Naming Conventions 

In the Solaris OE, all devices are represented by three different types of 
names, depending on how the device is being referenced: 

• Logical device names 

• Physical device names 

• instance names 



Note - The Berkeley Software Distribution (BSD) device names exist in 
the Solaris OE if the BSD compatibility packages are installed with the 
Solaris Developer, Entire Distribution, or Entire Distribution Plus the 
original equipment manufacturer (OEM) Solaris software group. The BSD 
device names, for example /dev/sdGa, are typically used for backward 
compatibility with old scripts. 



Logical Device Names 

Logical disk device names are symbolic links to the physical device names 
kept in the /devices directory. Logical device names are used primarily 
to refer to a device when you are entering commands on the command 
line. All logical device names are kept in the /dev directory. The logical 
device names contain the controller number, target number, disk number, 
and slice number 



Every disk device has an entry in both the /dev/dsk and /dev/rdsk 
directories for the block and character disk dev ices, respectively* To 
display the entries in the /dev/dsk directory, perform the command: 

# Is /dev/dsk 

cOtOdOsO c0t0d0s4 cOt2dOsO c0t2d0s4 cltldOsO cltld0s4 
cOtOdOsl cOtOdOsS c0t2d0sl c0t2d0s5 cltldOsl cltld0s5 
c0t0d0s2 c0t0d0s6 c0t2d0s2 c0t2d0s6 cltld0s2 cltld0s6 
c0t0d0s3 cOtOdOs? c0t2d0s3 c0t2d0s7 cltld0s3 cltld0s7 

• cOtOdOsO through cOtOdOs? - Identifies the device names for disk 
Slices 0 through 7 for a disk that is attached to Controller 0, at 
Target 0, on Disk Unit 0. 
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Introducing Solaris OE Device Naming Conventions 



• c0t2d0s0 through c0t2d0s7 - Identifies the device names for disk 
Slices 0 through 7 for a disk that is attached to Controller 0, at 
Target 2, on Disk Unit 0. 

• cltldOsO through cltidOs? - Identifies the device names for disk 
Slices 0 through 7 for a disk that is attached to Controller 1, at 
Target 1, on Disk Unit 0, 

Physical Device Names 

Physical device names uniquely identify the physical location of the 
hardware devices on the system and are maintained in the /devices 
directory. 

A physical device name contains the hardware information, represented 
as a series of node names, separated by slashes, that indicate the path to 
the device. To display a physical device name, perform the command: 

# Is -1 Zdev/dsk/cOtOaOsO 

lr^ncrwxrwx 1 root root 46 Jun 16 19:07 /dev/dSk/cOtQdOsO -> 
. . / . i /devices /pciSlf , Q/pci@l, l/ide@3/dad@0, 0 :a 

FC-AL disks will appear slightly different hecause they also display a 
World Wide Name (WWN). The following example was taken from a 
Sun™ Enterprise 3500 server: 

# la -1 /dav/rdflk/cOt0dOs0 

lrwxrvKTWx 1 root root 78 Jun 16 2000 /dev/rdsk/c0t0d0sO -> 

. . / . . /devices /sbus@2 , 0/SUNW, socal@d, 10000/ sf GO , 0/ssd§w21000Q20375b9ab6 , 0 1 

a, raw 
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Fig Lire 2-9 shows the device configuration hierarchy of an Ultra 5 
workstation. Not aU possible devices are included. 




pci@l, 1 
—T~\ ebus@l 

— H) fdthree@14, 
— Q se@14, 

— Q dad@0,Q 
— Q sd@2,Q 

Figure 2-9 The /devices Directory Structure 



Note - Various hardware platforms have different device trees. 



The top-most directory in the hierarchy is called the root node of the 
device tree. The bus nexus nodes and the leaf nodes below the root object 
have device drivers associated with them. 



A device driver is the software that communicates with the device. This 
software must be available to the kernel so that the system can use the 
device. 

During system initialization, the kernel identifies the physical location of 
a device. The kernel associates a node with an address, 
nodename@address t which is the physical device name. 

In Figure 2-9, dad@0 is the direct access disk device at address 0. 
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Instance Names 



Instance names are abbreviated names assigned by the kernel for each 
device on the system. 

An instance name is a shortened name for the physical device name. Two 
examples are shown; 

where sd is the disk name and n is the number, such as sdO for the 
first SCSI disk device. 

# dadn 

where dad (direct access device) is the disk name and n is the 
number, such as dadO for the first IDE disk device. 



:■ i ■ 
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Listing a System's Devices 

In the Solaris OE, there are several ways to list a system's devices, 
including: 

• Using the / etc /path_to_ins t file 
m Using the prtconf command 

• Using the format command 

The /etc/path_to_inst File 

For each device, the system records its physical name and instance name 
in the / etc /path_to_inst file. These names are used by the kernel to 
identify every possible device. This file is read only at boot time. 

The , etc , path_to_inst file is maintained by the kernel, and it is 
generally not necessary, nor is it advisable, for the system administrator to 
change this file. 

The following example shows entries in the / e t c / pa th_t o_ins t file, The 
text within the parentheses indicates what device is referred to by the 
entry and does not appear in the actual file. 

# more / etc / path_to_ inst 

# 

# Caution ! This file contains critical kernel state 
(output edited for clarity) 

" /pciGlf ,0" 0 "pcipsy" (PQbvisa^rjoUer/ / psycho''chqf)) 

» /pci@lf,Q/pciGQ, 1- 0 *simba" (PCI bus B) 

" /pci@l f | 0/pci£l , 1 zebus©!" 0 "ebus " (extended bus) 

" /pciGlf , 0/pci@l, l/ebus@l/power@14 f 724000 rt 0 "power" (power management bus) 
VpciSlf .O/pciei, l/ebus<ai/fdthree@14,3023f0" 0 "id" (floppy disk) 
Vpci(Slf ,0/pci@l,l/ebus@l/sUNW,CS4231@14, 200000" 0 "audioes" (crystal 
semiconductor) 

VpciQlf ,0/pciei,l/ebus@l/su814,3062f8" 1 N su" (mouse) 

VpciGlf, 0/pci@l, l/efaus@l/se@14, 400000" 0 H se w {serial ports A and B) 

Vpci@lf # 0/pci@l,l/ebus@l/su@14,3083fa" 0 "su" (keyboard) 

Vpciilf , Q/pci@l, l/ebus@l/ecpp@14,3043bc w 0 "eepp" (extended capability 

parallel port) 

« /pciGlf , 0/pciQl, l/ide<33 J ' 0 "uata" (ATA controller) 
M /pci@lf J 0/pci@l J l/ide@3/sd@2,0" 0 "sd" (CD-ROM) 
Vpci@lf , 0/pci@l, 1 /ide@3/dad<iO f 0 M 0 "dad" (hard disk) 
VpciSlf ,0/peiei f 1/networkei, 1" 0 "hme" (Fast Ethernet) 
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M /pciGlf , 0/pci@l , 1/SUNW, m64B@2 " 0 "m64 * (color memon' frame buffer) 

Vpci@lf , O/pciSl" 1 "simba" (PCI bus A controller) 

"/options" 0 "options" 

■ / sc s i_vhc i " 0 " s cs i_vhc i ■ 

" / pseudo " 0 " pseudo " 

The device instance number, shown in the preceding example, appears to 
the left of the device instance name when recorded in this file, 



Note - Different systems have different physical device paths- The 
preceding example shows an on-board peripheral component 
interconnect (PCI) bus configuration. 

The following is a /etc/path„to_inst file from a system that has a 
different bus architecture. In this case, it is an example of a system that 
has an on-board Sun System bus (SBus). 

I more /etc /path_ t o_infi t 

# 

# Caution! This file contains critical kernel state 
# 

"/sbus©lf,0" 0 "sbus" 
Vsbus@lf ,0/espdnia@e, 3400000" 0 tf dma" 
VsbusGlf , 0/espdma@e,8400000/esp@e, 8800000" 0 "esp" 

Vsbus@lf ,0/espdma@e, 8400000/esp@e, 88OOOO0/sd@3 , 0-" 3 "sd w 

VsbusGlf ,G/espdr^@e,8400000/esp<ae,880000G/sd£2,Q" 2 "sd" 

VsbusGlf , 0/espdnia@<5,8400000/esp@e, 880000D/sd@l, 0* 1 "sd* 

VsbusGlf , 0/esrjdrra@e, 34O0000/esp<2e, 880000Q/sd@0, 0" 0 "sd" 

Vsbus@lf ,Q/espdina@e,840000G/esp{ie, 8800000 /sd@6,0* 6 »sd" 

VsbusGlf ,0/espdma(&e, 8400000 /esp@e P 88OO0OO/sd^5 f 0 fr 5 "sd" 

VsbusGlf ,0/espdniaGe, 3400000/ espde, 880G000/sd§4, 0" 4 "sd* 

Vsbus@lf ( 0/espdma@e,8400000/esp@e,8800O00/st@3 f 0" 3 M st" 

VsbusGlf ,0/espdma@e, 8400000/espGe, 8800000/st§2 , 0" 2 "sf 

"/sbus@lf ,0/espdma@e,8400000/esp(3e r 8800000/st@l,0 ff 1 "st" 

Vsbus@lf ,0/espdrna@e, 3400000/espGe, 880G000/st@0, 0" 0 «st" 

tt /sbus@lf ,0/espdmate, 8400000/esp@e, 8800000/st@6 # 0" 6 "st" 

VsbusiSlf ,0/espdma<3e, 8400000/espGe, 8800000/st£a5, 0" 5 *st* 

VsbusGlf ,0/espdmaGe, 340000Q/esp§e, 8800000/st@4, 0* 4 "st w 
, . , < remaining lines removed > 

The following example is an /etc/path_to_inst file with an FOAL 
entry: 

* /sbus@2 , 0/SUNW, socalSd, 10000 /sf@0, 0/ssdGw2100002Q375b9ab6, 0 H 0 H ssd" 



Intermediate System Administration for the Solaris™ 9 Operating Environment 

Copyright 2003 Sun Microsystems, Inc. All R ignis Reserved. Sun Services, Revision A.2 



Listing a System's Devices 



The prtconf Command 



Use the prtconf command to display the system's configuration 
information, including the total amount of memory installed and the 
configuration of system peripherals, which is formatted as a device tree, 

The prtconf command lists ail possible instances of devices, whether the 
device is attached or not attached to the system, To view a list of only 
attached devices on the system, perform the command: 

# prtconf | girep -v not 

System Configuration; Sun Microsystems sun4u 
Memory size; 128 Megabytes 
System Peripherals (Software Nodes) 

SUNW, Ultra- 5_1Q 

options, instance #0 
pci, instance #0 

pci , instance #0 

ebus, instance- #0 

power, instance #0 
se, instance #0 
su H instance #0 
su, instance #1 
fdthree, instance 
network, instance #0 
Sl»7 r m64B, instance #0 
ide, instance #0 

dad f instance #0 
■;sd,.'. instance #0 
pci, instance #1 

scsi, instance #0 
scsi, instance #1 
pseudo, instance #0 




W 



Note - The grep -v not command is used to omit all lines containing 
the word "not" from the output (such as driver not attached). 
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The format Command 

Use the format command to display both logical and physical device 
names for all currently available disks. To view the logical and physical 
devices for currently available disks, perform the command: 

# format 

Searching for disks . . , done 

AVAILABLE DISK SELECTIONS: 

0. cOtOdO <SUW4.2G cyl 3880 alt 2 hd 16 sec 135> 

/pci@lf , 0/pci@l, l/ide@e/dad@0, 0 
%i cltOdO <SUN4.2G cyl 3880 alt 2 hd 16 sec 135> 
/pciGlf , 0/pci©l/SUNW, isptwo@4/sd@0 , 0 



Specify disk (enter its number) s 




Note - Press Control-D to exit the format command. 
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Reconfiguring Devices 

The system recognizes a newly added peripheral device if a 
reconfiguration boot is invoked or if the devf sadm command is nm. 

Performing a Reconfiguration Boot 

For example, you can use a boot process to add a new device to a newly 
generated /etc/path_to_inst file and to the /dev and /devices 
directories. 

The following steps reconfigure a system to recognize a newly attached 
disk. 

1 , Create the /reconfigure file. This file causes the system to check for 
the presence of any newly installed devices the next time it is 
powered on or booted. 

# touch /reconfigure 

Shut down the system by using the init 5 command. This 
command safely powers oft the system, allowing for addition or 
removal of devices. (If the device is already attached to your system, 
you can shut down to the ok prompt with the command init 0.) 

■ MM I r \ 

Turn off the power to all external de\"ices. 

Install the peripheral device. Make sure that the address of the 
device being added does not conflict with the address of other 
devices on the system. 

Turn on the power to all external devices. 

Turn on the power to the system. The system boots to the login 
window. 

Verify that the peripheral device has been added by issuing either 
the prtconf or format command. 

After the disk is recognized by the system, begin the process of defining 
disk slices, 



Note - If the /reconfigure file was not created before the system was 
shut down, you can invoke a manual reconfiguration boot with the 
programmable read-only memory (PROM) level command: boot -r. 



# init 5 
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Using the devfsadm Command 

Many systems are ninning critical customer applications on a 24-hour, 
7-day-a-week basis. It might not be possible to perform a reconfiguration 
boot on these systems. In this situation, you can use the devfsadm 
command. 

The devfsadm command performs the device reconfiguration process and 
updates the / etc / path_to_ins c file and the /dev and /devices 
directories during reconfiguration events. 

The devfsadm command attempts to load every driver in the system and 
attach all possible device instances. It then creates the device files in the 
/devices directory and the logical links in the /dev directory. In addition 
to managing these directories, the devfsadm command also maintains the 
/etc/path_to_inst file* 

To restrict the operation of the devfsadm command to a specific device 
class, use the -c option. 

devfsadm -c device_class 

The values for device_cla$s include disk, tape, port, audio, and 
pseudo. For example, to restrict the devf sadm command to the disk 

device -class* perform the command; 

J* ^ 

# devfsadm -c disk 

Use the -c option more than once on the command line to specify 
multiple device classes. For example, to specify the disk, tape, and audio 
device classes, perform the command: 

If devfsadm -c disk -c tape -c audio 

To restrict the use of the devfsadm command to configure only devices for 
a named driver, use the -i option 

devfsadm -i dr i ver_name 
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The following examples use the -i option. 

m To configure only those disks supported by the dad driver, perform 
the command: 



tI devf sadm dad 



• To configure only those disks supported by the sd driver, perform 
the command: 



# devf sa<3rn -i sd 



• To configure devices supported by the st driver, perform the 
command: 



# devf sadm -i st 



To print the changes made by the devf sadm command to the /dev and 
/devices directories, perform the command: 



# devf sadm -v 

To invoke cleanup routines that remove unreferenced symbolic links for 
devices, perform the command: 

# devf sadm H2 
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Performing the Exercises 

You have the option to complete any one of three versions of a lab. To 
decide which to choose, consult the following descriptions of the levels: 

• Level 1 - This version of the lab provides the least amount of 
guidance. Each bulleted paragraph provides a task description, but 
you must determine your own way of accomplishing each task. 

• Level 2 - This version of the lab is more difficult. Although each step 
describes what you shoidd do, you must determine which 
commands (and options) to input. 

• Level 3 - This version of the lab is the easiest to accomplish because 
each step provides exactly what you should input to the system. This 
lev el also includes the task solutions for all three levels. 
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Exercise: Configuring and Naming Devices (Level 1 ) 

In this exercise, you complete the following tasks: 

• Identify logical, physical, and instance names for disk devices 

* View the /etc/path_to_inst file for information about your boot 
disk 

• Add a new disk or tape drive to a system 

* Create new device files for the new disk or tape 





Preparation 



This exercise requires a system that is configured with an external disk or 
tape drive. During system boot, this external disk must remain powered 
off to avoid creating links and device files. 

Tasks 

Complete the following tasks: 

ft Identify the logical device name of your boot disk. Locate the logical 
device files in the /dev/dsk and /dev/rdsk directories for Slice 0 on 
this disk/ and record their true file types. 

ft Locate the physical device names that are associated with both 

logical device names that you found for your boot disk. Record their 
true file types. {Steps 1-5 in the Level 2 lab) 

ft In the .-./etc/path_to_inst file, identify and record the instance 
name for your boot disk, (Steps 6-7 in the Level 2 lab) 

ft Confirm that no links or device files exist for the disk or tape device 
mat you want to connect, Halt the system, and power on the device. 
Boot the system to its default run state. Run the devfsadm command 
in verbose mode to create new links and device files, and check the 
directories in which you created them to confirm that they exist. 
(Task 1, Steps 1-2, and Task 2, Steps 1-4, in the Level 2 lab) 



Managing Local Disk Devic9s 

Copyrighi 2003 Sun Microsystems. Inc. A If Righis Reserved. Sun Services, Revision A, 2 



2-23 



Exercise: Configuring and Naming Devices (Level 2) 



Exercise: Configuring and Naming Devices (Level 2) 

In this exercise, you complete the following tasks: 

# Identify logical, physical, and instance names for disk devices 

• View the ,/etc/path_to_inst file for information about your boot 
disk 

* Add a new disk or tape drive to a system 

• Create new device files for the new disk or tape 

Preparation 

This exercise requires a system that is configured with an external disk or 
tape drive. During system boot, this external disk must remain powered 
off to avoid creating links and device files. 



Task Summary 




Complete the following tasks: 

• Identify the logical device name of your boot disk. Locate the logical 
device files in the /dev/'dsk and /dev/rdsk directories for Slice 0 on 
this disk, and record their true file types. 

• Locate the physical device names that are associated with both 
logical device names that you found for your boot disk. Record their 
true file types, 

# in the / etc / path_to_ins t file, identify and record the instance 
name for your boot disk, 

* Confirm that no links or device files exist for the disk or tape device 
that you want to connect. Halt the system, and power on the device. 
Boot the system to its default run state. Run the devfsadm command 
in verbose mode to create new links and device files, and check the 
directories in which you created them to confirm that they exist* 
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Tasks 

Complete the following tasks, 

Task 1 - Identifying Device Files 

Complete the following steps: 

L Log in as the root user, and open a terminal window. Expand the 
window so that it occupies the entire screen area. Change to the 
/ dev / ds k director)'. 

2. List the files in this director}'. Identify the files related to the boot 
disk of your system. Most systems use cOtOdO. Locate the item 
related to Slice 0 on this disk, and display a long listing of it. 

Which type of file did you just locate? The file type indicator is the 
first character on the left side of the long listing. 

Record the full path name to which this file points. 

3. Highlight-' the path name yon recorded in Step 2 by double-clicking 
the path name, Use the Copy and Paste keys to copy and paste this 
path name into a long listing command. If you are not using the 
CUE, you need to type the path name. 

Which type of file is this? 

The command Is -1L cOtOdOsO displays the same information but 
shows only the link file name, not the real device file name, 

4. Change to the / dev/rdsk directory. Display a long listing of the 
same file name you selected in Step 2, 

Which type of file is this? 

Record the full path name to which this file points. 

5. Highlight the path name you recorded in Step 4. Use the Copy and 
Paste keys to copy and paste this path name into a long listing 
command. If you are not using the CDE, you need to type in the path 
name. 

Which type of file is this? 

The Is -1L cOtOdOsO command displays the same information but 
shows only the link file name, not the real device file name. 
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6. Change tine directory to the /etc directory. Display the contents of 
the path^to_inst file, 

7> Use the information from the previous steps to locate and record the 
entry for your boot disk, An Ultra 5 workstation, for example, would 
use cOtOdO as its hoot disk. This relates to the device file called 
dad@0 P 0 and is listed in the /etc/path_to„inst directory, 

The instance name is composed of the dad or sd tag and the number 
that precedes it in the / etc/patli_to_inst file. What is the instance 
name for the device listed in this step? 

Task 2 - Adding a New Disk or Tape Device 

Complete the following steps: 

1 . In the / dev / ds k and / dev / rm t d i rectories, confirm that no files exi st 
for your external disk or tape device, for example, 
/dev/dsk/cltOdOsO or /dev/rmt/O. If files for the external device 
do exist, ask your instructor to provide directions to remove them. 

2. Shut down your system to run state 0. 

3. Power on the external disk or tape drive attached to your system, 

4. Boot the system to its default run state. 

5. Log in as the root user, and open a tenninal window. Run the 
devf sadra command with the -v option to create new links and 
device files for the new disk or tape drive, Observe the messages that 
the devfsadm command displays, 

6. Confirm that new links and device files exist in the /dev/dsk and 
/dev/ f disk directories for disks or ,/dev/rmt for tape drives. 

■ y m- :r:: : : ; ■'■:-. : . : .: : .- : .-.r ]: 

W * w... ... .... J .. ..... .. 
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Exercise: Configuring and Naming Devices (Level 3) 



In this exercise, you complete the following tasks: 

• Identify logical, physical, and instance names for disk devices 

• View the /etc7path_to_inst file for information about your boot 
disk 

• Add a new disk or tape drive to a system 

• Create new device files for the new disk or tape 



Tliis exercise requires a system that is configured with an external disk or 
tape drive. During system boot, this external disk must remain powered 
off to avoid creating links and device files. 



• Identify the logical device name of your boot disk, Locate the logical 
device files in the /dev/dsk and /dev/rdsk directories for Slice 0 on 
this disk, and record their true file types. 

• Locate the physical device names that are associated with both 
logical device names that you found for your boot disk. Record their 
true file types. 

• in the /etc/path_to_inst file, identify and record the instance 
name for your boot disk. 

• Confirm that no links or device files exist for the disk or tape device 
that you want to connect. Halt the system, and power on the device, 
Boot the system to its default run state. Run the devf sadm command 
in verbose mode to create new links and device files, and check the 
directories in which you created them to confirm that they exist. 



Preparation 




Task Summary 





Complete the following tasks; 
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Tasks and Solutions 



Complete the following tasks* 

Task 1 - Identifying Device Files 

Complete the following steps: 

1. Log in as the rocr user, and open a terminal window* Expand the 
window so that it occupies the entire screen area. Change to the 
/dev/dsk directory. 



# cd /dev/dsk 



a Is 

i Is 



-1 cOtOdOsO 



List the files in this directory. Identify the files related to the boot 
disk of your system. Most systems use cOtOdO, Locate the item 
related to Slice 0 on this disk, and display a long listing of it. 



Which type of file did you just locate? The file type indicator is the 
first character on the left side of the long listing, 

Files in this directory are symbolic links, Tiie tetter 1 in the leftmost 
col limn id cn t ifies a 'symbolic, lit iL 

Record the full path name to which this file points* 

Systems that use PCI bus architectures list path names similar to the 
foil owing: 

. . / . . /devices /pci© If , 0/pci@l, l/ide@3/dad@0,Q;a 

Systems that use SBus architectures list path names similar to the 
following: ■ 

. . / . , /devices /lammuGf, e0000000/sbus@f ,e0001000/espdma(£f , 400000/esp@f , 
SOOOOO/sd^O.a 

3. Highlight the path name you recorded in Step 2 by double-clicking 
the path name. Copy and paste this path name into a long listing 
command, If you are not using the CDE r you need to type the path 
name. 



r Is -1 pathname 



Which type of file i> this? 

Files in this directory arc device files. The b character in the left-most 
column identifies a block-special device file. 

The command Is - 1L cOtOdOsO displays the same information but 
shows only the link file name, not the real device file name, 
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4. Change to the /dev/rdsk directory* Display a long listing of the 
same file name you selected in Step 2. 



Which type of file is this? 

Files in this directory are symbolic links. The letter l in the left-most 
column identifies a symbolic link. 

Record the full path name to which this file points, 

Systems that use PCI bus architectures list path names similar to the 
following: 



• / * . /devices /pciGlf , 0/pci@l, l/ide£3/dadG0, 0 :a r raw 

Systems that use SBus architectures list path names simitar to the 
following: 

. . / , , /devices /iommuQf , e000G00G/sbus@f , e00010QO/espdma<af , 40D000/esp@f ,8000 
00/sdG3, 0:a,raw 



5. Highlight the path name you recorded in Step 4. Use the Copy and 
Paste keys to copy and paste this path name into a long listing 
command :If you are not using CDE, you need to type in the path 
name. 



Which type of file is this? 

Files in this directory are device files. Ttie c cliaracter in the left-most 
co!t i nm idei i tifics a cha rac ter-special device file. 

The Is -1L cOtOdOsO command displays the same information but 
shows only the link file name, not the real device file name. 

6, Change to the /etc directory Display the contents of the 
path_to_inst file. 



7, Use the information from the previous steps to locate and record the 
entry for your boot disk, An Ultra 5 workstation, for example, would 
use cOtOdO as its boot disk. This relates to the device file called 
dad@0 , 0 and is listed in the /etc /path_to_ins t directory. 

Systems that use PCI bus architectures list path names similar to the 
following: 



# cd /d«rv/rdsk 
ft Is -1 cOtOdOsO 



# Is -1 pathname 




* cd /etc 

£ more path_to_inst 



/pci@lf t 0/pci@l, l/ide£3/dad<ao, 0 
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Systems that use SB us architectures list path names similar to the 
following: 

/ iommuGf , e0000Q00/sbus@f , e00G1000/espdma£f , 400000/esp@f , 800000/sd@3 , 0 

The instance name is composed of the dad or sd tag and the number 
that precedes it in the / e t c / pa th_to_ins t file. What is the instance 
name for the device listed in this step? 

dadO, sd3, or sdO r depending on the system architecture. 



# init 0 



ok boot 



Task 2 -Adding a New Disk or Tape Device 
Complete the following steps: 

1 . In the /dev/dsk and /dev/rmt directories, confirm that no files exist 
for your external disk or device, for example, /dev/dsk/ cltQdGsO 
or /tfev/rmt/a If files for the external device do exist, ask your 
instructor to provide directions to remove them. 

2. Shut down vour system to run state 0. 

3. Power on the external disk or tape drive attached to your system. 

4. Boot the svstem to its default run state. 



5. Log in as the root user, and open a terminal window, Run the 
devfsadm command with the -v option to create new links and 
device files for the new disk or tape drive. Observe the messages that 
the devfsadm command displays. 

# dervfsadm -v 

6. Confirm that new links and device files exist in the /dev/dsk and 
/dev^rdsk directories for disks or /dev/rmt for tape drives. 
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Exercise Summary 

Discussion - Take a few minutes to discuss w hat experiences, issues, or 
discoveries you had during the lab exercise. 

• Experiences 

• Interpretations 

• Conclusions 

• Applications 
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Partitioning the Hard Disk 




The format utility is a system administration tool used primarily to 
prepare hard disk drives for use in the Solaris OE. 

Although the format utility also performs a variety of disk-management 
activities, the main function of the format utility is to divide a disk into 
disk slices. 



Note - You do not need to partition the disk before you install the 
Solaris OE. 



introducing the Fundamentals of Disk Partitioning 

To divide a disk into slices: 

1. Identify the correct disk. 

2. Plan the layout of the disk. 

3. Use the format utility to divide the disk into slices. 

4. Label the disk with new slice information. 

Only the root user can use the format utility. If a regular user runs the 
format utility, the following error message appears: 

S format 

Searching for disk. . .done 

No permission {or no disk found) ! 
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Recognizing Disk Space and Undesirable Conditions 

Disk slices are defined by an offset and a size in cylinders. The offset is the 
distance from Cylinder 0, Figure 2-10 shows an example of disk slice sizes 
and offsets. 



Slice 0 


Slice 1 


Slice 6 


2521 


[ 320 


6051 S 


Cylinders 


[ Cylinders 


Cylinders J 


\ 

Offset 


Offset 


\ 

Offset 


Cylinder 0 


Cylinder 2521 


Cylinder 2&41 




Figure 2-10 Offsets and Sizes for Disk Partitions 



The offset for Slice 0 is 0 cylinders, and its size is 2521 cylinders. Slice 0 
; ^ begins on Cylinder 0 and ends on Cylinder 2520, 

The offset for Slice 1 is 2521 cylinders, and its size is 320 cylinders. Slice I 
begins on Cylinder 2521 and ends on Cylinder 2840, 

The offset for Slice 6 is 2841 cylinders, and its size is 6051 cylinders. Slice 6 
begins on Cylinder 2841 and ends on the last available cylinder, which is 
Cylinder 8S9L 
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Recognizing Wasted Disk Space 

Wasted disk space occurs when one or more cylinders are not allocated to 
a disk slice. Figure 2-11 shows a disk with cylinders that are not allocated, 



No Waste 
Slice 0 Slice 1 




Wasted Space 

Slice 0 Slice 1 
"2550 H 32a 
Cylinders P\ Cylinders 



[Cyjin 
!0\ 



Offset 
Cylinder 2521 



7 

2500-2520 
Offset Offset 
CylinderO Cylinder 2521 




Figure 2-11 A Disk Slice With Wasted Space 



Because the cylinders are not allocated to the disk slice, Cylinders 2500 



tli rough 2520 are unusable. 



Wasted disk space occurs during partitioning when one or more cylinders 
have not been allocated to a disk slice. This may happen intentionally ot 
accidentally. If there are unallocated slices available, then wasted space 
can possibly be assigned to a slice later on. 
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Recognizing Overlapping Disk Slices 

Overlapping disk slices occur when one or more cylinders are allocated to 
more than one disk slice. Figure 2-12 shows a disk with cylinders 
allocated to more than one disk slice. 



Nonoveriapping 



Overlapping 



Slice 0 


Slice 1 




..320 | S 


Cylinders 


Cylinders | £ 


V 




Offset 


Offset 



Slice 0 


Slice 1 


2590 


1 320- j S 


Cylinders / 


S Cylinders ] S 



Cylinder 0 



Cylinder 2521 



Overlap \ 
Offset of 70 Offset 
Cylinder 0 Cylinder 2521 




Figure 2-12 Disk Slices With Over lapping Cylinders 

In Figure 2-12, Cylinders 2521 through 2590 are overlapping two disk 
slices. 



This type of condition occurs when the size of one disk slice is increased 
and the starting cylinder number of the next disk slice is not adjusted. 
Only the format utility's modify command warns you of overlapping 
disk slices, 

parti tion> modify 

Select partitioning base: 

0. Current partition table (unnamed) 

1. All Free Hog 

Choose base (enter number) [0]? 0 

Warning: Overlapping partition (1) in table. 

Warning; Fix, or select a different partition table. 
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A 



Caution - Do not change the size of disk slices that are currently in use. 
When a disk with existing slices is repartitioned and relabeled, any 
existing data can become inaccessible. Copy existing data fro backup 
media before the disk is repartitioned, and restore the data to the disk 
after the disk is relabeled and contains a new file system. 



Introducing Disk Partition Tables 



As the root user, when you use the format utility and select a disk to 
partition, a copy of the disk's partition table is read from the label on the 
disk into memory and is displayed as the current disk partition table. 

The format utility also works with a file called /etc / format ,dat, which 
is read when you invoke the f ormat utility* 

The /etc/ format, da t file is a table of available disk types and a set oi 
predefined partition tables mat you can use to partition a disk quickly* 



Introducing Disk Labels 

The disk's label is the area set aside for storing information about the 
disk's controller, geometry, and slices. Another term used to describe a 
disk label is the volume table of contents (VTOC). The disk's label or 
VTOC is stored on the first sector of the disk. 

To label a disk means to write slice information onto the disk. If you fail to 
label a disk after defining slices, the slice information is lost. 

An important part of the disk label is the partition table, which identifies 
a disk's slices, the slice boundaries in cylinders, and the total size of the 
slices. 



Note - The terms disk slice and disk partition are interchangeable. 
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Figure 2-13 shows the relationship among the label on the disk, the 
current label in memory, and the predefined label in the 
/etc/ format . dat file, 

( On Disk ) ( In Memory ) ( /etc/format .dat ) 



Disk Label 
VTOC 




disk ' 



Current 
Partition 
Table 



verify 



ttflP 



name/ save J 



select 



Partition 
Tabfe 
Storage 



prxnt 

Figure 2-13 Partition Table Locations 

Using the format Command 



The f ormat utility is organised into two tiers of commands 

When you type format on the command line, the first tier of commands 
appears. This set of commands allow you to, among other functions, 
select a disk, select a partition, save new disk and partition definitions, 
and write the label to the disk. The top tier of commands is denoted by 
the format > prompt. 



The second tier of commands appears when you type partition from 
the forma t> prompt. This set of commands allow you to, among other 
functions, define the characteristics of the individual slices, print the 
existing partition table, and write the partition map and label to the disk* 
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Table 2-2 describes the terminology for disk partitioning. 



Table 2-2 Partition Table Terms and Usage 



Term 


Description 


Part 


The slice number Valid slice numbers are 0 through 7. 


Tag 


A value that indicates bow the slice is being used. 

0 - unassigned 

1 = boot 

2 - root 

3 = swap 

4 = usr 

5 - backup 

6 = stand 
8 - home 

Sun StorEdee™ Volume Manager array tags: 

14 = public (region) 

15 - private (region) 


Flag 


00 win ~ The disk slice is writable and mountable^ 

01 wu - The disk slice is writable and unmountable, This is the default state 
of slices dedicated for swap areas* 

10 rm = The disk slice is read-only and moun table. 

11 ru - The disk slice is read-only and unmountable. 


Cylinders 


The starting and ending cylinder number for the disk slice. 


Size 


The slice size: Mbytes (MB), Gbytes (GB), blocks (b), or cylinders (c)< 


Blocks 


'Hie total number of cylinders and the total number of sectors per slice. 
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Partitioning a Disk 



Caution - Do not change the size of disk slices that are currently in use, 



The following steps demonstrate how to divide a disk into slices: 
I. As the root user, type format at the prompt and press Return. 



I format 

Searching for disks .. . done 

AVAILABLE DISK SELECTIONS: 

0. cOtOdO <ST34321A cyl 8892 ait 2 hd 15 sec 63> 
/pciGlf i 0/pciGl, l/ide£3/dad@0, 0 

1. cltOdO <SUN1.3G cyl 1965 alt 2 hd 17,. sec : 80>. 



The format utility searches for all attached disks that are powered 
on. For each disk it finds, the format utility displays the logical 
device name, Sun marketing name, physical parameters, and 
physical device name, 

Choose the second disk by selecting the number located to the left of 
that disk's logical device name. From the preceding display, the 
n umber chosen is L The format utility's main menu appears. 




/pciGlf , 0/pci<il/scsi@l/sd@Q , 0 
Specify disk (enter its number) i 



Specify disk (enter its number) : 1 
selecting cltOdO 
[disk formatted] 




FORMAT MENU: 



disk - select a disk 

type - select (define) a disk type 

partition - select (define) a partition table 

current - describe the current disk 

format - format and analyze the disk 

repair - repair a defective sector 

label - write label to the disk 

analyze - surface analysis 

defect - defect list management 

backup - search for backup labels 

verify - read and display labels 

save - save new disk/partition definitions 

inquiry - show vendor, product and revision 

volname - set £ -character volume name 
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!<cmd> 
;ru i t 



format > 



- execute <cmd>, then return 



The specific menu selections that you can use to view, change, or 
commit disk slices include the following: 

partition Displays the Partition menu 

label Writes the current partition definition to the disk 

label 

verify Reads and displays the disk label 

quit Exits the format utility 



3. 

forma t> partition 



Type partition at the format prompt. The Partition menu appears. 



PARTITION MENU: 
0 
1 
2 
3 
4 
5 
6 

select 

modify 

name 

print 

label 

!<cmd> 

quit 



change 
change 
change 
change 
change 
change 
change 
change 
select 
ittodify 



partition 
partition 
partition 
partition 
partition 
partition 
partition 
partition 



a predefined table 
a predefined partition table 
name the current table 
display the current table 
write partition map and label to the disk 
execute <amd>, then return 
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The Partition menu enables you to perform the following functions: 

Specify the offset and size of up to eight slices 

Choose a predefined partition table from the 
/etc/ format.dat file 

Change the current partition table in memory 

Provide a means to identify the partition table in the 
/etc / format . dat file 

Display the current partition table in memory 

Write the current partition table to the disk label 

Escape from the utility and execute a command from 
the shell 



0-7 

select 

modify 
name 

print 
label 
! <cmd> 



Type print at the partition prompt to display the disk label that 
was copied to random access memory (RAM) when the format 
utility was invoked- 



partition> print 

Current partition table (unnamed) : 
Total disk cylinders available: 1965 



(reserved cylinders) 



Part Tag 


.Flag 


. Cylinders 


Size 


Blocks 


0 una s signed 


wm 


0 


0 


(0/0/0) 0 


1 unas signed 


wm 


I 0 


0 


(0/0/0) 0 


2 backup 


wu 


0 - 1964 


1,27GB 


(1965/0/0) 2672400 


3 unas signed 




0 


0 


(0/0/0) 0 


4 unas signed 




m 0 


0 


(0/0/0) 0 


5 unas signed 


wm 


0 


0 


(0/0/0) 0 


6 unas signed 


wu 


1 o 


0 


(0/0/0) 0 


7 unassigned 




0 


0 


(0/0/0) 0 



The name of the partition table appears in parentheses in the first 
line of the table. 
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The columns of the table have the following meanings: 

Part The disk slice number 

Tag The predefined, optional tag 

Flag The predefined, optional flag 

Cylinders Tile starting and ending cylinder number for the slice 

Size The slice size in blocks (b), cylinders (c), Mbytes (MB), 

or Gbytes (gb) 

Blocks The total number of cylinders and the total number of 
sectors per slice 



5, Select Slice 0 (zero) by entering 0 . 

partition> 0 

Part Tag Flag Cylinders Size 

L' unas signed wm 0 0 



Blocks 
(0/0/0) 



6. When prompted for the ID tag, type a question mark {?), and press 
Return to list the available choices. You can change a tag by entering 
a new' tag name. 

Enter partition id tag Eunassigned} : ? 

Expecting one of the following: (abbreviations ok) : 

unas signed boot root swap 

usr backup stand var 

home alternates 

Enter partition id tag [unassigned] : 

7. Type the tag alternates, and press Return, 

Enter partition id tag [unassigned] : alternates 

S. When prompted lor the permission flags, type a question mark {?), 
and press Return to list the available choices. You can change a flag 
by entering the new flag name. 

Enter partition permission flagsfwm]: ? 

Expecting one of the following: (abbreviations ok) : 

wm - read-write, mount able 

wu - read- write, unmount able 

rm - read-only, mount able 

ru - read-only, unmoun table 



Enter partition permission flags fwml : 
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9, Press Return to accept the default flag. 
Enter partition permission flags [ran] : <retuxn> 

10, Press Return to accept the starting cylinder of 0 (zero). 
Enter new starting cyl[0]: <roturn> 

1L Enter 400mb for the new partition size for Slice 0. 
Enter partition size [Ob, Gc, Oe, O.OOmb, O.OOgbj: 400mb 

12, Type print, and press Return* The Partition table appears, 
parti tion> print 

Current partition table {unnamed) : 

Total disk cylinders available: 1965 + 2 (reserved cylinders) 



Part Tag 


Flag 


Cylinders 


Size 


Blocks 


0 alternates 


ran 


0 - 602 


400.4.3MB 


(603/0/0) 820080 


1 unassigned 


ran 


0 


0 


(0/0/0) 0 


2 backup 


wu 


0 - 1964 


-1.27G8 


(1965/0/0) 2672400 


3 unassigned 


wm 


0 


0 


(0/0/0) 0 


4 unassigned 


ran 


0 


0 


(0/0/0) 0 


5 unassigned 


ran 


0 


0 


(0/0/0) 0 


6 unassigned 


wu 


0 


0 


(0/0/0) 0 


7 unassigned 


wm 


0 


• Q 


<0/0/0 ) 0 



The current partition tabic shows the change to Slice 0* 
Now adjust the starting cylinder for Slice L 

13. Select slice number 1 by typing 1> 

partition> 1 

Part Tag Flag Cylinders Size Blocks 

1 unassigned wm 0 0 (0/0/0) 0 

14. Type the tag swap, and press Return. 
Enter partition id tag [unassigned J : swap 

15. Type wu at the permission flags selection, and press Return, 
Enter partition permission flags [ran]: wu 

16. Enter the new starting cylinder for Slice 1 . 
Enter new starting cyl[0]: 603 

17. Enter the new partition size for Slice 1. 
Enter partition size [0b, Oc, 603e, O.OOmb, O.OOgb] : 60mb 
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18. Type print, and press Return, 
parti tion> print 

Current partition table (unnamed) : 

Total disk cylinders available: 1965 + 2 (reserved cylinders) 



Part Tag 


Flag 


Cylinders 


Size 


Blocks 


0 alternates 


wm 


0 - 602 


400. 43ME 


(603/0/0) 820080 


1 swap 


wm 


603 - 693 


60.43MB 


(91/0/0) 123760 


2 backup 


wu 


0 - 1964 


1.27GB 


(1965/0/0) 2672400 


3 unassigned 


wm 


0 


0 


(0/0/0) 0 


4 unassigned 


wm 


0 


0 


(0/0/0) 0 


5 unassigned 


wm 


0 


c 


(0/0/0) 0 


6 unassigned 


wu 


0 


0 


(0/0/0) 0 


7 unassigned 


wm 


0 


0 


(0/0/0) 0 



The current partition table shows the change to Slice L 



The new starting cylinder for Slice 1 is one greater than the ending 
cylinder for Slice 0. 

Now adjust the starting cylinder for Slice 7 
19- Type 7 to select Slice 7. 

partitions 7 

Part Tag Flag Cylinders Size Blocks 

7 unassigned wm 0 0 (0/0/0} 0 

20, Type the tag home, and press Return, 
Enter partition id tag [unassigned] : home 

2L Press Return to select the default flag. 
Enter partition permission flags [wm]: <retum> 

22. Type the new starting cylinder for Slice 7. 
Enter new starting cyl [01 : 694 

23, Type the new partition size for Slice 7 by typing a dollar ($) sign. 

Enter partition size [0b, 0c, 694e, O.OOmb, 0«00gb]: $ 
partitions 



Note - Enter a dollar ($) sign as a value for the last partition size to 
automatically assign the remaining space on the disk to this slice. 
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24. Type print to display the partition table. 
partition> print 

Current partition table (unnamed) : 

Total disk cylinders available: 1965 * 2 (reserved cylinders} 



Part Tag 

0 alternates 

1 swap 

2 backup 

3 unas signed 

4 unassigned 

5 unassigned 

6 unassigned 

7 home 



Flag 
wm 
wm 
wu 
wm 
wm 
wm 
wu 
wm 



Cylinders 
0 - 602 
603 - 693 
0 - 1964 

0 
0 
0 
0 

694 - 1964 



Size 
400,43MB 
60.43MB 
1.27GB 
0 
0 
0 
0 

844.02MB 



Blocks 
(603/0/0) 820080 
<91/0/0) 123760 
(1965/0/0) 2672400 



(0/0/0) 
(0/0/0) 
(0/0/0) 
(0/0/0) 
(1271/0/0) 



0 
0 

o 

0 

1728560 



Add up the cylinders in the Blocks column for Slice 0, Slice I. and 
Slice 7. The number should equal the total number of cylinders 
contained in Slice 2. 



25. After checking the partition table to ensure that there are no errors, 
label the disk by typing label. 



partition> label 

Ready to label disk, continue? y 
parti tion> 




Saving a Partition Table to the /etc /format -dat File 



Use this optional procedure to add the newly created partition table to the 
/etc/ format , dat file. You can save customized partition tables to the 
/etc/ f ormat * da t file and use them to quickly partition other disks of the 
same type on the system. 



Note - Remember that, by default the system saves the new partition 
information to the . / format . dat file .You must enter the full path of the 
/etc /format. dat file to update the proper file. 
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To save a customized partition table, display the Partition menu and 
perform the following steps: 

1. Type nam© to enter a unique name for the current partition table. 
Frequently, the disk manufacturer 's name is used. 

parti tion> nam© 

Enter table name [remember quotes): 




Note - Quotes are only required if the partition table name is more than 
one word, for example, "SUNl ♦ 3G Generic." 

2. Exit the Partition menu, 
partition^ quit 

3. Type save to save the new partition tabJe information, and enter the 
full path name for the /etc/ format .dat file. 

forma t> save 

Saving new partition definition 

Enter £ i le name [ 11 . / £ ormat , da t n ] : /etc /format . dat 

Using the Customized Partition Table 

To retrieve a customized partition table, display the format menu and 
perform the following steps: 

1. Type partition, 
f ormat > partition 

2. Type select to display a list of customized partition tables, and 
choose the desired table by entering its assigned number 

parti tion> select 
0. SUN1.3G 
li original 
2, SUN4.2 

Specify table (enter its number) [3] : 0 

3. Label the disk with the selected partition table, 
partition^ label 

Ready to label disk, continue? yes 
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4. Exit the Partition menu, 
partition* quit 

5. Read the new disk label. 

forma t> verify 
Primary label contents : 



Volume name = 
ascii name = 
pcyl 

ncyl - 
acyl = 
nhead - 
nsect = 
Part Tag 

0 alternates 

1 swap 

2 backup 

3 unas signed 

4 unas signed 

5 unassigned 

6 unassigned 

7 home 



format > quit 



< > 

<SUN1.3G cyl 1965 alt 2 

3500 
1965 
2 



hd 17 sec 80> 



17 

80 
Flag 
wm 
win 
wu 
wm 
wm 

Wm 
WU 

wm 



Cylinders 



0 

603 
0 
0 
0 
0 
0 

694 



602 
693 
1964 



1964 



Exit the format utility. 



Size 



400. 
60. 
1. 
0 
0 
0 
0 

■844, 



43MB 
43MB 
27GE 



02MB 



Blocks 

(603/0/0) 820080 

(91/0/0) 123760 

(1965/0/0) 2672400 

(0/0/0) 0 

(0/0/0) 0 

(0/0/0) 0 

(0/0/0) 0 

(1271/0/0) 1723560 
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Managing Disk Labels 



Every disk in the Solaris OE has a label set aside for storing information 
about the disk's controller, geometry, and slices. 

Viewing the Disk VTOC 

You can use two methods for locating and viewing a disk's label or 
VTOC: 

# Use the verify command from the format utility 

• Invoke the prtvtoc command from the command line 

Reading a Disk's VTOC Using the verify Command 

The verify command enables you to view a disk's VTOC from within the 
format utility, To read a disk's VTOC, perform the following steps: 

1, At the format prompt, enter the verify command, and press 



Return, 






Volume name - 
ascii name M 



<SUN1.3G cyi 

3500 

1965 



< 



> 



1965 alt 2 hd 17 sec 80> 



pcyl 

ncyl 

acyl 

nhead 

nsect 



2 
17 
80 



Part Tag 



Flag 



Cylinders Size Blocks 



0 root 

1 swap 

2 backup 

3 unassigned 

4 unassigned 

5 unassigned 

6 unassigned 

7 home 



wm 0-602 400.43MB (603/0/0) 820080 

wm 603 - 693 60.43MB (91/0/0) 123760 

0 - 1964 1.27GB (1965/0/0) 2672400 

wm 0 0 (0/0/0) 0 

wm 0 0 (0/0/0) 0 

wm 0 0 (0/0/0) 0 

wm 0 0 (0/0/0) 0 

wm 694 - 1964 844.02MB (1271/0/0) 1723560 



Type quit or q, and press Return to exit the format menu. 
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Reading a Disk's VTOC Using the prtvtoc Command 



The prtvtoc command enables you to view a disk's VTOC from the 
command line. To view a disk's VTOC from the command line, type the 
following; 



* prtvtoc /dev/rdsk/clt0d0e2 

* /dev/rdsk/clt0dQs2 partition map 

* Dimensions: 
★ 



512 bytes /sector 
30 sec tors /track 
17 tracks /cylinder 
1360 sec tors /cylinder 
3500 cylinders 
1965 accessible cylinders 

Flags ! 

1: unmountable 
10 : read-only 




* 






First 


Sector 


Last 


* Partition 


•Tag 


Flags 


Sector 


Count 


Sector 


0 


2 


00 


0 


320080 


820079 


1 


3 


00 


820080 


123 7&> 


943839 


2 


\ 3 


00: 


0 


2672400 


2672399 


7 


8:-: 


•oo ; 


943840 


1728560 


2672399 



The disk label information includes the following fields: 

Describes the logical dimensions of the disk. 



Dimensions 
Flags 

Partition 

Tag 

Flags 

First Sector 



Describes the flags that are listed in the partition 
table, 

A slice number It is described further in 
Table 2-2 on page 2-38, 

A value used to indicate how the slice is being 
used. It is described further in Table 2-2 on 
page 2-38. 

The 0 0 flag is read / write, mountable; 01 is 
read /write, unmountable; and 10 is read only. 
These are described further in Table 2-2 on 
page 2-38. 

Defines the first sector of the slice, 
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Sector Count Defines the total number of sectors in the slice. 

Last Sector Defines the last sector number in the slice. 

Mount Directory If the field is empty, the slice is currently not 

mounted and no entry exists in the /etc /vf stab 
file. 



Relabeling a Disk 

Save a disk's VTOC to a file by using the prcvtoc command. This allows 
you to relabel the disk by using the fmthard command if one of the 
following situations occurs: 

• The VTOC on the disk has been destroyed. 

• You accidentally changed the partition information on the disk and 
did not save a backup label in the /etc /format .da t file. 

To save a disk's VTOC to a file, perform the command: 
# prtvtoc /dev/rxisk/clt0d0s2 > /vtoc/cltOdO 

The fmthard Command 

To relabel a disk, you can save the output of the prtvtoc command into a 
file on another disk and use it as the datafile argument to the fmthard 
command . 

fmthard -s datafile /dev/rdsk/c#t#d#s2 



Caution - The fmthard command cannot write a disk label on an 
iinlabeled disk. Use the format utility for this purpose. 



If the need to relabel a disk arises and the VTOC was previously saved to 
a file, the following options are available: 

• Rim format, select the disk, and label it with the default partition 
table. 

• Use the fmthard command to write the desired label information, 
previously saved to a datafile back to the disk, 

* fmthard -s /vtoc/cltOdO /dev/rdBk/cat0aOs2 
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Performing the Exercises 



Yon have the option to complete any one of three versions of a lab* To 
decide which to choose, consult the following descriptions of the levels; 

• Level 1 - This version of the lab provides the least amount of 
guidance. Each bulleted paragraph provides a task description, but 
you must determine your own way of accomplishing each task. 

• Level 2 - This version of the lab is more difficult. Although each step 
describes what you should do, you must determine which 
commands (and options) to input. 

m Level 3 - This version of the lab is the easiest to accomplish because 
each step provides exactly what you should input to the system. This 
level also includes the task solutions for all three levels, 





Managing Local Disk Devices 

Copyright 2003 Sun Microsystems. Inc. All Rights Reserved. Sun Services, Revision A.2 



2-51 



Exercise; Working With Disks and Partition s (LeveH) 



Exercise: Working With Disks and Partitions (Level 1) 

In this exercise, you complete the following tasks: 

• Use the format utility to partition a disk 

• Use the prtvtoc and fmthard commands to repair a corrupted disk 
label 

Preparation 

This exercise requires a system configured with an external disk. 

Tasks 

Complete the following tasks: 

« Use the format command to list the disks currently attached to your 
system. Use the prtvtoc command to identify a disk that does not 
currently hold any mounted file systems/ Examine the information 
that the prtvtoc command displays. Record the name of a disk that 
has no mount directory listed. 

(Steps 1-4 in the Level 2 lab) 

« Use the format command to divide the unused disk into four slices 
of equal size, Use Slices 0, 1, 3, and 4. Set all other slices to size 0, 
Manually change the size of Slice 0 so that it ends 25 Mbytes into the 
space assigned to Slice 1. 

(Steps 4-11 in the Level 2 lab) 

• Attempt to correct the overlap by using the Modify menu. Record 
the message that appears. Then correct the overlap by using the all 
free hog option. Verify your disk label with the prtvtoc command, 

(Steps 12-18 in the Level 2 lab) 
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• Create a directory called /vtoc* Rim the prtvtoc command to read 
the label of the disk you modified, and save its output in a file in the 
/vtoc directory. Use the dd command from Step 21 of the Level 2 lab 
to destroy the label on the same disk, Attempt to read the disk label 
by using the prtvtoc command, and record the result. If required, 
use the format command to write a default label to the disk. Use the 
fmthard command to restore the label by using the output from the 
prtvtoc command that you saved earlier. Verify that the new label 
exists. 

(Steps 19-25 in the Level 2 lab) 
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Exercise: Working With Disks and Partitions (Level 2) 

In this exercise, you complete the following tasks; 

• Use the format utility to partition a disk 

• Use the prtvtoc and fmthard commands to repair a corrupted disk 
label 



Preparation 



This exercise requires a system configured with an external disk, 

Task Summary 



m this exercise, you accomplish the following: 

* Use the format command to list the disks currently attached to your 
system. Use the prtvtoc command to identify a disk that does not 
currently hold any mounted Me systems. Examine the Mount 
Directory field in the information that the prtvtoc command 
displays. Record the name of a disk mat has no mount directory 
listed- 

* Use the format command to divide the unused disk into four slices 
of equal size. Use Slices G, 1, 3, and 4. Set all other slices to size 0. 
Manually change the size of Slice 0 so that it ends 25 Mbytes into the 
space assigned to Slice 1. 

• Attempt to correct the overlap by using Option 0 from the Modify 
menu. Record the message that appears. Then correct the overlap by 
using the all free hog option. Verify your disk label with the 
prtvtoc command. 

• Create a directory called /vtoc. Run the prtvtoc command to read 
the label of the disk you modified, and save its output in a file in the 
/vtoc directory Use the dd command to destroy the label on the 
same disk. Attempt to read the disk label by using the prtvtoc 
command, and record the result. If required, use the format 
command to write a default label to the disk. Use the fmthard 
command to restore the label by using the output from the prtvtoc 
command that you saved earlier. Verify that the new label exists. 
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Tasks 

Complete the following steps: 

L Log in as the root user, and open a terminal window, Run the 
format command, 

2. Record the list of disks presented by the format command, for 
example, cOtOdO and cltOdO. 

Press the Control-D keys to exit the format utility- 

3. Use the prtvtoc command to list the VTOC for each of the disks 
that you found in the previous step. Examine the Mount Directory 
field in the information that the prtvtoc comma rid displays. Record 
the name of a disk that has no mount directory listed- This is an 
unused disk, 

4. Run the format command again, Select the unused disk from the list 
of disks presented. 

5. Display the Partition menu, Print the current partition table, and 
record the number of megabytes assigned to Slice 2, For example, if 
the disk reports 4 Gbytes, record 4000 Mbytes. 

Mbytes: ^1|BB| 

6. Divide the number of megabytes by 4. Use the result as the number 
of megabytes to assign as disk space to four slices- Round down to 
the next whole megabyte if the result includes a fraction. 

Mbytes/ 4: 

7. Display the Partition menu again, Select Slice 0, Accept the defaults 
for tags and flags. Start this first slice on Cylinder 0. Enter the 
resulting number of megabytes from the previous step for the slice 
size. Print the partition table again to verify the change. 

8. Set the sizes of Slices 1, 3, and 4 so that they are the same as Slice CL 
Begin each successive slice on the cylinder that follows the ending 
cylinder of the previous slice. 

9. Set Slices 5, 6, and 7 to start at Cylinder 0, and assign them 0 Mbytes, 

10. Print the partition table. Is there any overlap of ending and 
beginning cylinders for any of the slices listed? Proceed to the 
following steps to introduce this problem. 
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1L Add 25 to the number Mbytes /4 value listed in Step 6. 
(Mbytes/4) + 25: 

Change Slice 0 so that it uses the new size listed above, 

The partition table should now indicate that Slice 0 ends after Slice 1 
begins. 

12. Use the modify command from the Partition menu to attempt to fix 
this problem. Select Item 0 to modify the current partition table. 

Which warnings appear? 

13. Modify the partition table. Select Item 1 to use the All Free Hog 
method. 

14. The partition table appears. Observe the Cylinders and Size columns, 
and notice that they are all zero. 

15. Respond to the prompts to continue the process. Select Slice 4 as the 
All Free Hog slice. Use the size listed in Step 6 for Slices 0, 1, and 
3. Set the other slices to Size 0, 

At the end of this process,, you should have three slices of equal size, 
where Slice 4 takes up any extra room if it exists, 

16. Name the partition table "SA239partition ll / then label the disk. 

17. Quit the partition menu/and save your new partition table to the 
/etc /format .dat file. Carefully read the message that is displayed 
by the format utility, and enter the correct file name. Quit the 
format utility when you have finished, Use the cat command to 
view- the contents of the ./etc/format. dat file. Note that your 
information is appended to the file. 

IS. Verify your new partition table with the prtvtoc command. 

19. Create a directory called /vtoc. 

20. Use the prtvtoc command to print the partition table that you just 
created, and save its output to a file in the /vtoc directory. Name the 
file so that it corresponds with the disk you are examining, Use the 
cat command to verify that valid information exists in the file mat 
you create. 
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21. Use the following dd command to destroy the disk label. Be certain 
to specify the correct disk device name for the of- argument. Enter 
all other arguments exactly as listed, 

# dd if=/dev/zero of-/d*v/rdsk/clt0d0s2 be=512 count-1 

i+0 records in 
1+0 records out 
# 

22. Attempt to read the label from the same disk by using the prtvtoc 
Command. 

What happens? 

23. If the prtvtoc command reported an "Unable to read Disk 
geometry" message, use the format command to place a default 
label on the disk for which you destroyed the label earlier. 

If the prtvtoc command reports that only Slice 2 exists on the disk, 
skip to the next step. Otherwise, perform the commands: 

# format 

Searching for disks,.. done 

cltOdO: configured with capacity of 4.00GB 

AVAILABLE DISK SELECTIONS: 

0. cOtOdO <Seagate Medalist 34342A cyl 8892 alt 2 hd 15 sec 63> 
/pciQ 1 £ ,0/pci@l, 1 i idee 3 / dad§0 , 0 

1. cltOdO <3UN4.2G cyl 3880 alt 2 hd 16 sec 135> 
/pci$lt ,0/pci&X/pci@2/Stiw, isptwo@4/sd@3 , 0 

Specify disk' {enter- its number): 1 
selecting cltOdO 
[disk format ted] : 

Disk not labeled. Label it now? Y 

(format menu) 

forma t> q 
# 

# prtvtoc Zoe^/i?dBk/clt0d0s2 

24. Use the fmthard command to write to the disk the label information 
you saved earlier. 

25. Attempt to read the lahel from the same disk. 
Was this successful? 
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Exercise: Working With Disks and Partitions (Level 3) 

In this exercise, you complete the following tasks: 

• Use the format utility to partition a disk 

• Us the prtvtoc and fmthard commands to repair a corrupted disk 
label 

Preparation 

This exercise requires a system configured with an external disk. 

Task Summary 

In this exercise, you accomplish the following: 

• Use the format command to list the disks currently attached to your 
sy stern. Use the prtvtoc command to identify a disk that does not 
currently hold any mounted file systems, Examine the Mount 
Directory field m the information that the prtvtoc command 
displays. Record the name of a disk that has no mount directory 
listed. 

• Use the format command to divide the unused disk into four slices 
of equal size. Use Slices 0, 1, 3, and 4. Set all other slices to size 0. 
Manually change the size of Slice 0 so that it ends 25 Mbytes into the 
space assigned to Slice 1. 

• Attempt to correct the overlap using Option 0 from the Modify 
menu. Record the message that appears, Then correct the overlap by 
using the all free hog partition, Verify your disk label with the 
prtvtoc command. 

• C r e< 1 1 1 j ; t directory called /vtoc. Run the pr tv t oc comman d to read 
the label of the disk you modified, and save its output in a file in the 
/vtoc directory. Use the dd command to destroy the label on the 
same disk. Attempt to read the disk label by using the prtvtoc 
command, and record the result, If required, use the format 
command to write a default label to the disk. Use the fmthard 
command to restore the label by using the output from the prtvtoc 
command mat you saved earlier. Verify that the new label exists. 
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Tasks 



Complete the following steps: 

1. Log in as the root user, and open a terminal window. Run the 
format command. 



# format 



2. Record the list of disks presented by the format command, for 
example, cOtOdO and cltOdCL 

Press Control -D to exit the formal: utility* 

forma t> Control -D 

# 

3. Use the prtvtoc command to list die VTOC for each of the disks 
you found in die previous step. Examine the Mount Directory field 
in the information that the prtvtoc command displays. Record the 
name of a disk that has no mount directory listed. This will be an 
unused disk, - 

prtvtoc /dev/rdsk/clt0d0s2 

Unused disk: Your entry will depend on your system, 

4 Run the format command again. Select the unused disk from the list 
of disks presented, 

# format 

(list of disks) 

Specify disk (enter its number) i x- 

5. Display the Partition menu. Print the current partition table, and 
record the number of megabytes assigned to Slice 2. For example, if 
the disk reports 4 Gbytes, record 4000 Mbytes. 

forma t> part 
partition^ print 

Mbytes: Your entry will depend on your system. 

6, Divide the number of megabytes by 4, Use the result as the number 
of megabytes to assign as disk space to four slices. Round down to 
the next whole megabyte if the result includes a fraction. 

Mbytes/ 4: Your entry will depend on your system. 
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7, Display the Partition menu again, Select Slice 0. Accept the defaults 
for tags and flags. Start this first slice on Cylinder 0. Enter the 
resulting number of megabytes from the previous step for the slice 
size. Print the partition table again to verify the change. 

parti tion> 0 

Part Tag Flag Cylinders Size Blocks 

0 unassigned wm 0 0 (0/0/0) 0 



Enter partition id tag [unassigned] : <Return> 
Enter partition permission flags [wm] : <Heturn> 
Enter new starting cyl[0]: 0 

Enter partition size [Ob, Oc, Oe, 0 , OOmb, O.OOgb] : 300mb 
partition> print 
( partition table) 

8. Set the sizes of Slices 1, 3, and 4 so that they are the same as Slice 0. 
Begin each successive slice on the cylinder that follows the ending 
cylinder of the previous slice. 

parti tion> ? 
(Partition menu) 
partition> 1 

Parr Tag Flag Cylinders Size Blocks 

1 unassigned wm 0 0 £0/0/0) 0 

Enter partition id tag [unassigned] : <Beturn> 
Enter partition permission flags[wm]: <S»tum> 
Enter new starting oyl[0] : 452 

Enter partition size [0b, 0c, 0e, G.OOmb, O.OQgfo]: 3 OOmb 
parti tion> print 
(partition table) 

9. Set Slices 5, 6, and 7 to start at Cylinder Q, and assign them 0 Mbytes. 

partition> ? 
(Partition menu) 
partition 5 

Part Tag Flag Cylinders Size Blocks 

5 unassigned wm 0 0 (0/0/0) 0 



Enter partition id tag [unassigned] : <Retiim> 
Enter partition permission flagstwm]: <Retum> 
Enter new starting cyl[0] t 0 

Enter partition size [0b, 0c, Oe, O.OOmb, O.OOgb]: Om 
parti tion> 
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10. Print the partition table. Is there any overlap of ending and 
beginning cylinders for any of the slices listed? Proceed to the 
following steps to introduce this problem. 

parti tion> print 

1L Add 25 to the number Mbytes/ 4 value listed in Step 6, 
(Mbytes/ 4) + 25: Your entry ivill depend on your system. 
Change Slice 0 so that it uses the new size listed previously. 

partition> ? 
( Partition menu) 
partition> 0 

Part Tag Flag Cylinders Size Blocks 

0 unassigned wm 0-451 300.16MB (452/0/0) 614720 

En t er part i t i on id tag [ unass igned 3 : <Refcuni> 
Enter partition permission flags [wm] ; <Ratur*i> 
Enter new starting cyltO] : 0 

Enter partition size [614720b, 452c, 451e, 300 + 16mb, 0,29gb}i 325mb 
partitions print 
{partition table) 

The partition table should now indicate that Slice 0 ends after Slice 1 
begins. 

12. Use the modify command from the Partition menu to attempt to fix 
this problem, Select Item 0 to modify the current partition table. 

partitions ? 
(Partition menu) 
partitions modify 
Select partitioning base: 

0, Current partition table (unnamed) 

1; All Free -.Hog ■ 
Choose base {enter number) [0]? 0 

Which warnings display? 

Warning: Overlapping partition (1) in table. 
Warning: Fix, or select a different partition table. 
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13. Modify the partition table. Select Item 1 to use the All Free Hog 
option, 

parti tion> modify 

Select partitioning base: 

0. Current partition table (original) 

1. All Free Hog 

Choose base (enter number) [0]? 1 

14, The partition table appears, Observe the Cylinders and Size columns, 
and notice that they are all zero; for example: 

Pare Tag Flag Cylinders Size Blocks 



0 root wm 0 0 (0/0/0) 0 

L swap wu 0 0 (0/0/0) 0 

2 backup wu 0 - 1964 1.27GB (1965/0/0) 2672400 

3 unassigned wm 0 0 (0/0/0) 0 

4 unassigned wm 0 0 (0/0/0) 0 

5 unassigned wm 0 Q. (0/0/0) 0 

6 usr wm 0 0 (0/0/0) ; 0 

7 unassigned wm 0 0 (0/0/0) 0 



15* Respond to the prompts to continue the process, Select Slice 4 as the 
All Free Hog partition, Use the size listed in Step 6 for Slices 0, 1, 
and 3. Set the other slices to Size 0. 

Do you wish to continue creating a new partition 
table based on above table [yes]? yms 
Free Hog partition [6 J ? 4 

Enter size of partition '0' [0b, 0c, O.OOrrb, O.OOgb]: 300mb 

Enter size of partition '1' [0b, 0c, O.OOmb, O.OOgb]: 300mb 

Enter size of partition '3' [Ob, Qc, O.OOmb, O.OOgb] : 300mb 

Enter size of partition '5' [0b, Qc, O.OOmb, O.OOgb]: 0 

Enter size of partition '6' [0b ( Qc, O.OOmb, O.OOgb]: 0 

Enter size of partition r 7' [0b, 0c, O.OOmb, O.OOgb]: 0 

At the end of this process, you should have three slices of equal size, 
where Slice 4 takes up any extra room if it exists. 

16. Name the partition table ■ SA2 3 9part i t i on 1 \ then label the disk. 

Okay to make this the current partition table [yes]? y 
Enter table name (remember quotes) : "SA239partition" 

Ready to label disk, continue? y 

parti tion> 
parti tion> quit 
(format menu) 
f ormat> 
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17, Save your new partition table to the /etc / format , dat file. Carefully 
read the message that is displayed by the format utility, and enter 
the correct file name. Quit the format utility when you have 
finished. Use the cat command to view the contents of the 

/etc /format. dat file. Note that your information is appended to 
the file. 

forma t> save 

Saving new disk and partition definitions 

Enter file name f M ./ format . dat " ] : /etc/ format -dat 

forma t> quit 

# 

# cat /etc/format. dat 

18, Verify your new partition table with the prtvtoc command. 

# prtvtoc /dev/rdsk/clt0d0s2 

19, Create a directory called /vtoa 

ft mkdir /vtoc 

20, Use the prtvtoc command to print the partition table that you just 
created, and save its output to a file in the /vtoc directory. Name the 
file so that it corresponds with the disk you are examining. Use the 
cat command to verify that valid Information exists in the file that 
you create, 

# prtvtoc /dev/rdsk/clt0d0s2 > /vtoc/cltOdO 

# cat /vtoc/cltOdO 

21: Use the following dd command to destroy the disk label. Be certain 
to specify the correct disk device name for the of = argument. Enter 
all other arguments exactly as listed. 

# dd if=/dev/zero of =/dev/rdsk/clt0d0s2 bs=512 count =1 

1+0 records in 
1+0 records out 

# ^SWlWfc: 

22. Attempt to read the label from the same disk by using the prtvtoc 
command. 

# prtvtoc /derv/rdsk/clt0d0s2 

What happens? 

Different disk types present different results. SCSI disks might report 
messages Hint indicate that the disk label is unreadable, for example: 

prtvtoc: /dev/rdsk/clt0d0s2 : Unable to read Disk 
geometry 
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IDE disks might report a partition table where only Slice 2 remains defined, 
for example: 

Partition Tag Flags Sector Count Sector 
Mount Directory 

2 5 01 0 

17801280 17801279 



23. If the prtvtoc command reported an " Unable to read Disk 
geometry" message, use the format command to place a default 
label on the disk for which you destroyed the label earlier. 

If the prtvtoc command reports that only Slice 2 exists on the disk, 
skip to die next step. Otherwise, perform the commands: 

I format 

Searching for disks . . . done 

cltOdO; configured with capacity of 1.3GB 



AVAILABLE DISK SELECTIONS : 

0. cOtOdO <Seagate Medalist 34342A cyl 8892 alt 2 hd 15 sec 63> 

/pci@lf ,0/pci©l, l/ide@3/aad$a, 0 
3U cltOdO <SUN1.3G cyl 1965 alt 2 hd 17 sec S0> 
/pciOlf , O/pci@l/scsi@l/sd@O,0 
Specify disk (enter its number) : 1 

selecting cltOdd ran V f . / V 

[disk formatted] 

Disk not labeled, Label it now? Y 

(format menu) 
format> q 
# 

# prtvtoc /dev/rdak/clt0d0s2 

24, Use the fmthard command to write to the disk the label information 
voli saved earlier. 

4t fmthard -s Zvtoc/cltOdO /dev/rdsk/clt0d0s2 

fmthard: New volume table of contents now in place, 
# 
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25. Attempt to read the label from the same disk, 
# prtvtoc /dev/rdsk/clt0d0fl2 

Was this successful? 

This command should successfully read the disk label. 
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Introducing the Solaris™ Management Console 

The Solans Management Console is a Java technol ogy -based tool for the 
administration of systems. It provides a central integration point for the 
configuration and administration of important applications and services. 

The Solaris Management Console software simplifies the job of 
configuring and administering servers. With po inland -click graphical 
user interface (GUI) tools, the Solaris Management Console makes the 
Solaris OE easy to administer, especially for administrators who are not 
familiar with the UNIX environment. 

Starting the Solaris Management Console 

The Solaris Management Console can be started from the command Line 
or from within the Application Manager by clicking the Solaris 

Management Console icon. 

■ 

Log in to your system as rooty and type smc& in a terminal window. You 
can start the Solaris Management Console as a normal user, but some 
tools and applications are not available to you. When you initiate the 
Solaris Management Console for the first time, it can take a few minutes 
to launch. 

■ 

Note - The information provided in this course is only a small subset of 
tlie overall capabilities of the Solaris Management Console. 
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Using the Solaris Management Console Tools 

The default toolbox for a Solaris Management Console server includes the 
following folders and tools: 

System Status This category includes System Information, Log 
Viewer, Processes, and Performance. 

System This category includes Users, Projects, Computers 

Configuration and Networks, and Patches. 

Services This category includes Scheduled Jobs, 

Storage This category includes Mounts and Shares, Disks, 

and Enhanced Storage. 

Devices and This category includes Serial Ports. 

Hardware 



The Solaris Management Console enables local users and administrators 
to register remote Solans Management Console servers and applications 
on the network they want to administer. When you access the Solaris 
Management Console, it dynamically configures tree views of those 
registered hosts and sendees. Point and click with the mouse to invoke an 
application remotely on a selected Solaris Management Console server 
and view the application's GUI on the local display. 

Introducing the Help Screen 

The online help for the Solaris Management Console provides an 
alternative to standard documentation. The information panes that appear 
in both the Solaris Management Console and the Solaris Management 
Console Toolbox Editor provide the steps necessary to perform the tasks 
executed within these windows. In addition, the Help menu item 
Contents displays a window that further describes the features and 
functions of the window components. 
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Figure 2-14 shows the help functionality of the Solaris Management 
Console, 
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Figure 2-14 Solaris Management Console Help View 

Restarting the Solaris Management Console 

If you have trouble accessing Solaris Management Console, the reason 
might be that the Solaris Management Console server is not running or is 
in a problem state. 



To determine if the Solaris Management Console server is running, as the 
root user perform the command; 

# /etc/init .d/iji±t .wbem status 



If the Solaris Management Console server is running, a response similar to 
the following returns: "Solaris Management Console server 
version 2.1.0 running on port 898," 
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To stop the Solaris Management Console server, as the root user, perform 
the command: 

# /etc/init*d/init,tttoem stop 

The following response returns; "SMC stopped. " 

To start the Solaris Management Console server, as the roo t user, perform 
the command: 

# /etc/init .d/ijiit .wbem start 

After a short time, the following response returns; "SMC server 
started, " 



Identifying the Functional Areas of the Solaris 
Management Console 



The Solaris Management Console and the Solaris Management Console 
Toolbox Editor windows are divided into functional areas as follows; 

• Navigation pane 

• View pane 

. ... 

• Information pane 

• Location bar 
« Status bar 
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Figure 2-15 shows these divisions. 




Informalion pane 



Context Help end 
Console Events tabs 



Status bar * 

Fi g 11 re 2- 1 5 Sol aris Management Console Overview 



Note - The Location bar does not appear by default when you first launch 
the Solaris Management Console. Click View on the Menu bar, select the 
Show option, and select the Location option to display the Location bar. 



Navigation Pane 



The Navigation pane works like a frame in a web page. Clicking an item 
in the Navigation pane determines what appears in the View pane. The 
turner icon is displayed to the left of items that represent a group of items. 
Click the icon or the item to expand or collapse the group. 



The Navigation pane is displayed or not displayed, depending on the 
Show setting in the View menu. Click View on the Menu bar, select the 
Show option, and select or deselect the Navigation option. 
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View Pane 



The View pane displays the contents of the node selected in the 
Navigation pane. The contents could be a folder or a tool 

If the node selected in the Navigation pane is a folder, the View pane 
displays the contents of that folder. 



If the node selected is a simple tool, such as the Process tool the View 
pane displays a list of current processes. If the node selected is a complex 
tool, such as User Manager, the View pane displays additional tools, such 
as the tools for user accounts and email accounts. Select one of the 
additional tools, such as the user accounts node, and the View pane 
displays the contents of the tool. 

Information Pane 



The Information pane at the bottom of the Solaris Management Console 
window displays either context help lor the object selected in the 
Navigation pane or a list of events and alarms for all Solaris Management 
Console events. 

The Context Help tab and Console Events tab determine what is shown in 
the Information pane. Click the Context Help tab to display context help 
for the object selected. Click the Console Events tab to display a list of 
events and alarms for all Console events. 

The Information pane is displayed or not displayed, depending on the 
Show setting in the View menu. Click View on the Menu bar, select the 
Show option, and select or deselect the Information option- 

Location Bar 



The Location bar, beneath the tool bar in the Solaris Management Console 
window, displays a Home Toolbox icon and a Toolbox field. Click the 
Home Toolbox icon to open the home toolbox. The Toolbox field indicates 
the current toolbox and the item currently selected in the toolbox. Click 
the button to the right of the Toolbox field to display a pull-down menu of 
recent toolboxes visited. Select a toolbox from the pull-down menu to 
open that toolbox. 

The Location bar is displayed or not displayed, depending on the Show 
setting in the View menu. Click View on the Menu bar, select the Show 
option, and select or deselect the Location option. 
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Status Bar 

The Status bar, located across die bottom of the Solaris Management 
Console window, displays three panes. The ieft pane of the Status bar 
indicates the number of nodes directly subordinate to the node selected in 
the Navigation pane. The center pane of the Status bar indicates Console 
activity. A moving bar inside the center pane functions as an activity 
indicator when Console activity occurs. The right pane of the Status bar 
provides progress information during some Console tasks, 

The Status Bar is displayed or not displayed, depending on the Show 
setting in the View menu. Click View on the Menu bar, select the Show 
option,, and select or deselect the Status bar option. 
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Partitioning a Disk by Using the Solaris Management 
Console Disks Manager Tool 

The following section describes how to partition a disk by using the 
Solaris Management Console Disks Manager Tool (from this point on, 
referred to as the Disks Tool). 



Partitioning the Disk Using the Disks Tool 

To partition a disk by using the Disks Tool, you must first locate the 
Storage folder within the Navigation pane, The Storage folder consists of 
the Mounts and Shares folder, the Disks Tool> and the Enhanced Storage 
tools. 



Use the Disks Tool to perform the following tasks: 
Display information about a specific disk 
Create Solaris OE disk partitions ■ 
List partitions 



Copy the layout of one disk to. another disk of the same type 
Change the disk's label 



Perform the following steps to partition a disk by using Disks Tool: 

1, Click Storage and then the Disks Took The Log In: User Name 
window appears, prompting yon to enter the root password. 

Figure 2-16 shows the Log In: User Name window* 

Logs '1, User N4m» i 



Entw i twr rams wii password, 
and did: OK If you are 
penrulled vo assume a roJe. Lhe 
Role t lame la$n dialog bo\i i$ 
displayed not! Otherwise, lhe 
sdtttwt toolbox a displayed in 
tb* Console 

Sole: [/ you are Use &ra person 
w log in 14 Ilia* Solans 
M*Mg«nenl CtomI « «ry«r. .you 



Figure 2-16 Log In: User Name Window 



Managing Local Disk Devices 

Copyright 2003 Sun Mrcrosysiems. Inc. All Rights Reserved Sun Services, Revision A.2 



2-73 



Partitioning a Disk by Using the Solaris Management Console Disks Manager Too! 



Figure 2-17 shows the Solaris Management Console after you have 
opened the Storage folder and then the Disks Tool. The figure shows 
a system with two disks. 



COHSOte E4tf action vim GO Help 



4* Wanaflpm»ntTt>oi& ^ .4© eOKhfO £TJU*2DA tvl 9:22 43 ME B21 T 5* MB 4 92M8 

f gTtiis Computer HIqcTUMO SUM 3ft cy I 1304 881*6 tHJimilB 4 64 M8 0 351b 

Jj System 9ialus 

*• Jfo System C MtpmM 

»-% 3 write; 

Mt.ijf.Vj ^ftd Eft*** 

ErMvancefl Scrape 
6- gj Dftv4tesana HanhrtfG 



This toohs for 

OMtt 



If you xJttted t'taLimthc ngjn pan*, double- dick r_»tika lo ha casting dtdir 



£tl«t an ritm » y 0 fc^y cnronmlioa iboa a ^eafi c it* ■ - the disk in the npto p*rj* and dick 

• To fftat* Solans disk pirtilicms - in. Hi* nghl pint; idect th- di* to pwtiDonwjd dick 
An linn-, 1 Uraife Sftfomfc Ftltfckafat. .. . - : ". ' 



-J 



Figure 2-17 Management Tools: Solaris Management Console Window 



2 Click to select a specific disk. Then click the Action menu on the 
Menu bail?. 

The Action menu displays a list of functions that this window 
performs. 

3. To display a graphical representation of a disk's partitioning, select 
the Properties option from the Action menu. 
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Figure 2-18 shows a 1.3 Gbyte drive. 
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Figure 2-13 Properties Window 

Basic disk information, including size, address, and available free 
space, is reported, Move the cursor over any partition on the Disk 
Layout bar to see the size and geometry of the partition slice in a 
pop-up window, 

4, To create a new partition map on a disk, select the Create Solaris 
Partitions option from the Action menu. 
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Figure 2-19 shows the first window that you use to create partitions 
on a disk. This window prompts you to choose between creating 
custom-sized partitions and creating equal-sized partitions. In the 
figure, Create Custom-Sized Partitions is selected. 
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Figure 2-19 Create Solaris Partitions on Disk Window 
5. Click Next after choosing how to divide the disk. 
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Figure 2-20 shows the next window that you use to create partitions 
on a disk. You are prompted to select the number of partitions. You 
can select up to seven partitions. You can also create some of them as 
zero-length partitions, 
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Figure 2-20 Create Solaris Partitions on Disk Window - Specify Number 
of Partitions 



6, After selecting the number of partitions, click Next. 



Managing Local Disk Devices 

Copynghi 2003 Sun Microsystems, Inc. AH Rights Reserved. Sun Services, Reviswn A.2 



2-77 



Partitioning a Disk by Using the Solaris Management Console Disks Manager Tool 



Figure 2-21 shows the window that enables you to display each 
partition. When a partition is displayed, the size of the partition is 
also displayed- You can choose to display the size of the partition in 
either a percentage of the disk space or the total number of 
megabytes, and you can adjust the size of each partition. The disk 
layout bar graphically represents the disk partitions. Place the cursor 
over the bar to view the amount of space that remains to be 
partitioned. 
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Figure 2-21 Create Solaris Partitions on Disk Window - Specify Size and 
Use of Parti hons 

7. Use this window to adjust the size of each partition to the desired 
size. Click Next when you have finished sizing the partitions. 
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Figure 2-22 shows the window that allows you to specify the 
partitions on which to create file systems. 
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Figure 2-22 Create Solaris Partitions on Disk Window - Specify Where to 
Create File Systems 

8. In the Create Solaris Partitions on Disk window, check the box under 
the file system that corresponds to each partition you want to use. 
Click Next w hen vou are finished making your selections. 
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Partitioning a Disk by Using the Solaris Management Console Disks Manager Tool 



Figure 2-23 displays a list of the disk partitions you have created. 
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Figure 2-23 



Create Solaris Parti tkms on Disk Window 



Confirmation 



If you are satisfied with the partitions, click Finish. The new 
partitioning is written, and the newfs utility runs on the partitions 
von selected to create a new file system. 
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Figure 2-24 displays the disks window of the Solaris Management 
Console after you have completed partitioning the disk. The created 
partitions are displayed in the Management Tools; Solaris 
Management Console window. 
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Figure 2-24 Management Tools: Solaris Management Console Window - 
Partitioning Completed 
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Performing the Exercises 



Yon have the option to complete either of these labs. To decide which to 
choose, consult the following descriptions of the levels: 

• Level 1 - This version of the lab provides the least amount of 
guidance. Each bu lie ted paragraph provides a task description, but 
you must determine your own way of accomplishing each task. 

• Level 2 - This version of the lab is guided, Although each step 
describes what you should do, you must determine which 
commands (and options) to input. 

There are only two levels of this tab due to the nature of working within 
the Solaris Management Console GUL Should you require assistance with 
any of the steps, consult the help functionality from the Solaris 
Management Console. 
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Exercise: Working With the Solaris Management Console 
(Level 1) 

In this exercise, you complete the following tasks: 

• Launch the Solaris Management Console Disks Manager Tool 

• Partition the second drive of your system to match the boot drive 



Preparation 



This exercise requires a system with at least two disks, one of which is 
available for the student to re-partition. 



Tasks 




Complete the following tasks: 

• Launch the Solaris Management Console, and choose the Disks Tool 
from the Storage folder, 

• Authenticate as the root user by typing the root password. 

• View information about your boot drive from the Disks Tool, and 
make note of it, 

; # On your spare hard drive, make four equal sized partitions on 
Slices 0, l f 3, and 4- 

\; \ 
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Exercise: Working With the Solaris Management Console 
{Level 2) 

In this exercise, yon complete the following tasks: 

• Launch the Solaris Management Console Disks Manager Tool 

• Partition the second drive of your system to match the hoot drive 



Preparation 

This exercise requires a system with at least two disks, one of which is 
available for the student to re-partition. 



Task Summary 




Complete the following tasks: 

• Launch the Solaris Management Console, and choose the Disks Tool 
from the Storage folder. 

• Authenticate as the root user by typing the root password, 

• View information about your boot drive from the Disks Tool, and 
make note of it, 

• On your spare hard drive, make four equal sized partitions on 
Slices 0, % % and 4. 

Tasks 

Complete the following steps: 

L Launch the Solaris Management Console from the command line or 
by using Application Manager. 

2. Open the Disks Tool. 

3. Select your boot drive from the Disks Tool, and record the partition 
information listed, 

4. Select your spare drive from the Disks Took Select Create Solaris 
Partitions from the Action menu. 

5. Choose Create Equal-Sized Partitions, and click Next, 



Intermediate System Administration tor the Solaris™ 9 Operating Environment 

Copyright 2003 Sun Microsystems. \nc. Ail Rights Reserved. Sun Services, Revision A. 2 



Exercise: Working With the Solaris Management Console (Level 2} 



6. Specify Number of Partitions as 4. Click Next. 

7. Verify that you have four equal-sized partitions on Slices 0, 1, 3, 
and 4. Click Next. 

8. Check the box beside Slice 4 to create a File System, and click Next, 

9. After reviewing your choices and verifying that they are correct, 
click Finish, 

The Solaris Management Console window refreshes, and you should 
see the four equal -sized partitions listed in the View Pane. 

10. Exit from the Solaris Management Console, 
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Exercise Summary 



Discussion - Take a few minutes to discuss what experiences, issues, or 
discoveries you had during the lab exercise- 

# Experiences 

# Interpretations 
m Conclusions 

« Applications 
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Module 3 



Managing the Solaris OE File System 



Objectives 



Upon completion of this module, you should be able to: 
Describe Solaris OE file systems 
Create a new uf s file system 
Check the fOe system by using the fsck command 
Resolve file system inconsistencies 
Monitor file svstem use 

The following course map shows how this module fits into the current 
instructional goal. 

Managing File Systems 



■ N reducing : 
the Solars™ 

OE Directory 
Hierarchy 



Managing 
Local Disk 
Devices 



Managing 
the Solaris OE 
File System 



Performirjg 
Mounts and 
Unmounts 



Figure 3-1 Course Map 
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Introducing Solaris OE File Systems 

A file system is a collection of files and directories that make up a 
structured set of information. The Solaris OE s up ports three different 
types of file systems: 

« Disk-based file systems 

• Distributed file systems 

• Pseudo file systems 

Disk-based File Systems 

Disk-based file systems are found on hard disks, CD-ROMs, diskettes, and 
DVDs. The following are examples of disk-based file systems: 

• uf s - The UNIX rile system in the Solaris OE is based on the 
Berkeley fast file system, : 

• hsfs - The High Sierra file system is a special-purpose file system 
developed for use on CD-ROIy! media, 

• pcfs - The PC file system is a UNIX implementation of the disk 
operating system (DOS) file allocation table (FAT32) file system. The 
pcfs file system allows the Solaris OE to access PC-DOS formatted 
file systems. Users can use UNIX commands for direct read and 
write access to PC-DOS files, 

• udfs - The Universal Disk Format file system is used for optical 
storage targeted at DVD and CD-ROM media, The UDF file system 
allows universal data exchange and supports read and write 

operations- 
Distributed File Systems 

Distributed file systems provide network access to file system resources. 

• NTS - The network file system allows users to share files among 
many types of systems on the network. The NFS file system makes 
part of a file svstem on one system appear as though it were part of 
the local directory tree. 
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Pseudo File Systems 



P so udo file systems are memory based. These file systems provide for 
better system performance, in addition to providing access to kernel 
information and facilities, Pseudo file systems include; 

• tmpfs - The temporary file system stores files in memory, which 
avoids the overhead of writing to a disk-based file system. The tmpfs 
file system is created and destroyed every time the system is 
rebooted. 

• swapfs - The swap file system is used by the kernel to manage 
swap space on disks. 

• fdfs - The file descriptor file system provides explicit names for 
opening files by using file descriptors (for example, /dev/fd/0, 
/dev/fd/1, /dev/fd/2) in the /dev/fd directory, 

• proofs - The process file system contains a list of active processes in 
the /proc directory. The processes are listed by process number. 
Information in this directory is used by commands, such as the ps 
command. 

m mntfs - The mount file system provides read-only information from 
the kernel about locally mounted file systems. 
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Creating a New uf s File System 

This section describes the uf s file system in the Solaris OE. 

Viewing the Solaris OE ufs File System 

The user views the ufs file system differently than the operating system 
does in the Solaris OE. To a user, a file system appears as a collection of 
files and directories used to store and organize data for access by the 
system and its users. To the operating system, a file system is a collection 
of control structures and data blocks that occupy the space defined by a 
partition, which allow for data storage and management. 

The Solaris OE stores data in a logical file hierarchy often consisting of 
several file systems. This file hierarchy is referred to as the Solaris 
directory hierarchy. 
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Figure 3-2 shows the Solaris OE hierarchy beginning with the / (root) 
directory. 




Figure 3-2 Solaris OE Directory Hierarchy 




Note - Figure 3-2 is not a complete representation of a Solaris OE 
directory hierarchy. 



A uf s file system is created on a disk slice before it is used in the 
Solaris OE, Creating a uf s file system on a disk slice enables the Solaris 
OE to store UNIX directories and files, 
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Creating a New uf s File System 



Figure 3-3 shows how the uf s file systems are located on various disk 
slices, 
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Figure 3-3 Solaris uf s File Systems Residing on Disk Slices 




The Solaris OE uf s file system contains the following basic support 
structures. 



Disk Label (VTOC) 

The disk label (VTOC) contains the partition table for the disk, The VTOC 
resides in the first disk sector (512-byte blocks). Only the first disk slice 
contains a VTOC, although file systems created on any slice skip the first 
sector in case it might contain a VTOC. 
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Boot Block 

The bootstrap program (bootblk) resides in the 15 disk sectors 
(Sectors 1-15) that follow the VTOC Only the / (root) file system has an 
active boot block. However, space is allocated for a boot block at the 
beginning of each file system. 

Primary Superblock 

The superblock resides in the 16 disk sectors (Sectors 16-31) that follow 
the boot block. Hie superblock is a table of information that describes the 
file system, including: 

• The number of data blocks 



File system state flag: clean, stable, active, logging, or unknown 



When the file system is created, each cylinder group replicates the 
superblock beginning at Sector 32. This replication protects the critical 
data m the superb lock against catastrophic loss. 




Backup Superblocks 
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Creating a New uf s File System 



Cylinder Groups 

Each file system is divided into cylinder groups with a minimum default 
size of 16 cylinders per group. Cylinder groups improve disk access. 

The file system constantly optimizes disk performance by attempting to 
place a file's data into a single cylinder group, which reduces the distance 
a head has to travel to access the file's data. The file system stores large 
files across several cylinder groups, if needed. 

Cylinder Group Blocks 

The cylinder group block is a table in each cylinder. group mat describes 
the cylinder group, including: 



• The number of i nodes 

• The number of data blocks in the cylinder group 

• The number of directories 

• Free blocks, free inodes, and free fragments in the cylinder group 

• The free block map 

• The used inode map 



ur- : 
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Figure 3-4 shows a series of cylinder groups in a ufs file system. 




Figure 3-4 Solaris ufs File System Structure 



The ufs Inode 

An inode contains the following information about a file: 

• The type of file and the access modes 

• The user identi fication ( U ID) and g ro u p i d en ti fi ca tic n ( G ID ) 
numbers of the file's owner and group 

• The size of the file 

• The link count 

• The time the file was last accessed and modified and the inode 
changed 

• The total number of data blocks used by or allocated to the file 

• Two types of pointers; direct pointers and indirect pointers 
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Creating a New uf s File System 



Figure 3-5 shows some of the information contained in an inode. 
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Figure 3-5 Structure of a uf s mode 
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Note - To view some of the information contained in a file or directory 
inode, use the Is -1 command. To view the mode number assigned to 
the file or directory, use the Is -i command, 



Direct Pointers 



Inside the inode there are 12 direct pointers, which contain addresses for 
the file's first 12 data blocks. The 12 direct pointers can each reference 
8-Kbyte data blocks for a file that is up to 96 Kbytes. 



Indirect Pointers 

The three types of indirect pointers within an inode are: 

• Single indirect pointer - Refers to a file system block that contains 
pointers to data blocks. This file system block contains 2048 
additional addresses of 8-Kbyte data blocics, which can point to an 
additional 16 Mbytes of data. 

• Double indirect pointer - Refers to a file system block that contains 
single indirect pointers. Each indirect pointer refers to a hie system 
block that contains the data block pointers. Double indirect pointers 
point to an additional 32 Gbytes of data. 

• Triple indirect pointer - Can reference up to an additional 64 Tbytes 
of data, However, the maximum size of a ufs file system is limited to 
1 Tbyte due to die maximum address space of 32-bits for the device 
drivers. 



Data Blocks 

The remaining space allocated to the ufs file system holds data blocks. 
Data blocks are allocated, by default, in 8-Kbyte logical block sizes. The 
blocks are further divided into 1- Kbyte fragments, For a regular file, the 
data blocks contain the contents of the file. For a directory, the data blocks 
contain entries that associate the inode numbers and the file names of the 
files and directories contained in that directory. 



Within a file svstem, those blocks that are currently not being used as files, 
directories, indirect address blocks, or storage blocks are marked as free in 
the cylinder group map. This map also keeps track of fragments to 
prevent disk performance from degrading. 
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Fragmentation 

Fragmentation is the method used by the uf s file system to allocate disk 
space efficiently. Files less than 96 Kbytes in size are stored using 
fragmentation. 

By default, data blocks can be divided into eight fragments of 1024 bytes 
each. Fragments store files and pieces of files smaller than 8192 bytes. For 
files larger than 96 Kbytes, fragments are never allocated and full blocks 
are exclusively used. 

Figure 3-6 shows a fragment in a data block. 

Data block 
8192 bytes 



1024 

Bytes 





















T 

Fragment 
Figure 3-6 



Divided Data Block 




If a file contained in a fragment grows and requires more space, it is 
allocated one or more additional fragments in the same data block. 
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Figure 3-7 shows the contents of two different files stored in fragments in 
the same data block* 

Data block A 
8192 bytes 




Figure 3-7 Two Files Stored in One Data Block 

/**\ A 1 tl f Sp 

For example, if Filel requires more space than is currently available in 
the shared data block, the entire contents of mat expanding file are moved 
by the uf s file system into a free data block. This requirement by the uf s 
file system assures that ail of a file's fragments are contained in a whole 
data block. The uf s file system does not allow fragments of the same file 
to be stored in two different data blocks* 
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Using the newf s Command 

To use the disk to store directories or files, a file system must be created 
on every disk partition, As the root user, you can construct a ufs file 
system on a disk slice by using the newf s command. 

The newf s command is an easy-to-use front-end to the mkf s command, 
which you use to create file systems. The newf 3 command is located in 
the /usr/sbin directory. 

Caution - The newf s command is destructive. The command overwrites 
data tli at resides on the selected disk slice. 

To create a ufs file system, by using the newf s command, perform the 
following steps: 

1. As the root user, create a file system on a slice of a newly 
partitioned disk by entering the command: 

9 newf s /dev/rdsk/c0to<J0s7 

2. The newf s command asks for confirmation before continuing. Verify 
that the correct disk slice on the correct disk is selected. To proceed, 
type y; to terminate the process, type n. 

newf s : construct a new file system /dev/rdsk/c0t0d0s7 : (y/n) ? y 

The newf s command displays information about the new file system 
being created. 

Zdev/rdsk/cGtOdOs?: 10510856 sectors in 2927 cylinders of 27 tracks, 

133 sectors 

5132.3MB in 183 cyl groups (16 c/g, 28,05MB/g, 3392 i/g) 
super-block backups (for fsck -F ufs -o b=#) at: 

32, 57632, 115232, 172332, 230432, 288032, 345632, 403232, 460832, 
518432,576032, 633632, 691232, 748832, 806432, 864032, 921632, 979232 
(output omitted) 
1 

The first line printed by the newf s command describes the basic disk 
geometry. The second line describes the ufs hie system created in 
this slice, Hie third and remaining lines list the beginning sector 
locations of the backup superb locks. 
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Note - This process also creates a lost+f ourid directory for the uf s file 
system, which is a directory that is used by the file system check and 
repair (fsck) utility. 



3, Repeat Steps 1 and 2 for even' disk slice on any newly partitioned 
disk that needs to contain a file system. 

The newf s command reserv es between 1 and 10 percent of the file system 
space for maintenance of the file system. This free space, referred to as 
minfree, specifies the amount of space on the slice that is reserved or 
held back from regular users. You can use the newf s -m %fre& 
command to preset the percentage of free space when you create a new 
file system. 

To show the value of minfree on a file system, use the fstyp command. 
The following command shows the minfree value for the file system on 







the cQtOdOsO device. 






# fstyp 


-v /dev/rdsk/cQtQtfOsO | 


head -10 




ufs 






'■\ '•: :. V U .i 




magic 


11954 


format dynamic time Fri Mar 15 07: 


S3: 40 2002 


sblkno 


16 


cblkno 24 


iblkno 32 dblkno 


480 


sbsize 


3072 


cgsize 2048 


cgoffset 32 cgmask 


OxfffffffO 


ncg 


17. 


:• size 121905 


blocks 114000 




bsize 


8192 


shift 13 


mask OxffffeOOQ 




fsize 


1024 


shift 1 10 


mask OxfffffcOO 




frag 


8 . ..... 


shift 3 


fsbtodb 1 




minfree 


10% 


maxbpg . 2048 


optirti time 




maxcontig 16 


rotdelay . Oms 


rps 90 





To change the minimum percentage value of free space on an existing file 
system, you can use the tunef s -m %free command. 

The following command changes the minimum percentage of free space 
on the /dev/rdsk/cO tOdOsO device to 1 percent 

# tunef s -m 1 Zdev/rdsk/cOtOdOsO 

minimum percentage of free space changes from 10% to 1% 
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Checking the File System by Using the fsck Command 

A file system can become damaged if it is corrupted from a power failure, 
a software error in the kernel, a hardware failure, or an improper 
shutdown of the system. The file system check program, fsck, checks the 
data consistency of a fOe system and attempts to correct or repair any 
inconsistencies or damage found. 



Caution - Never run the fsck command on a mounted file system. This 
could leave the file system in an unusable state- It could also delete data. 
The / (root), /usr, and /var file systems should have the fsck command 
run on them while in single-user mode. 



Every time you boot a system, the operating system determines which file 
systems the fsck command should check. The fsck command checks and 
repairs any problems encountered in file systems before they are 
mounted. 



Note - The status of a file system's state flag determines whether the file 
system needs to be scanned by the fsck command. When the state flag is 
"clean," "stable," or "logging," file system scans are not run. 

Data Inconsistencies Checked by the fsck Command 

The fsck command makes several passes through a file system. During 
each pass, the fsck command checks for several types of file system 
in consis tencies . 

Superblock Consistency 

The file system superblock is checked for inconsistencies involving such 
parameters as file system size, free block count, and free inode count 

Cylinder Group Block Consistency 

The fsck command checks any unallocated data blocks claimed by 
modes, the unallocated data block count, and the unallocated inode count. 
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Inode Consistency 

The fsck command checks for the allocation state of inodes, as well as the 
type, the link count, duplicate blocks (blocks already claimed by another 
mode), bad blocks, the inode size, and the block count for each inode. Any 
unreferenced inode with a nonzero link count is linked to the file system's 
1 os t+ found directory 



Data Block Consistency 

The fsck command cannot check ordinary data blocks, but it can check 
directory data blocks. In directory data blocks, the fsck command checks 
for modes that point to unallocated blocks, unallocated blocks tagged as 
in use, allocated blocks tagged as free (incorrect inodes for . and , . ) and 
directories not connected to the file -system , These directories are linked 
back to the file system in its lost+ found directory. 



The lost+found Directory 

% ilk I ill % %r' f 

The fsck command puts files and directories that are allocated but 
unreferenced in the lost+ found director}' located in that file system. The 
inode number of each file is assigned as the file name. If the lost+f ound 
directory does not exist, the fsck command creates it. If not enough space 
exists in the Iosc+ found director}; the fsck command increases the 
directory's size, 

Noninteractive Mode 

During a normal system boot, the fsck command operates in 
noninteractive mode, which is often referred to as preen, or silent mode. 
In this mode, the fsck command addresses only minor inconsistency 
problems that can be corrected. If a more serious inconsistency is found 
and a decision has to be made, the fsck program terminates and requests 
the root password to enter single- user mode. Execute the fsck command 
in interactive mode to continue. 
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Interactive Mode 

In interactive mode, the fsck command lists each problem it encounters, 
followed by a suggested corrective action in the form of a question that 
requires a yes or no response. 

The following example shows how the fsck command displays a 
message that asks if you want to correct the block count. 

# fsck /d*v/rdflk/c0tQd0s7 

** /dev/rdsk/c0t0d0s7 
** Last Mounted on /export /home 

Phase 1 - Check Blocks and Sizes 
INCORRECT BLOCK COUNT 1=743 {5 should be 2} 
CORRECT? 

If you respond with yes, the fsck command applies the corrective action 
and moves on, If you respond with no, me fsck command repeats the 
message about the original problem and suggests corrective action. It does 
not fix the inconsistency until you respond yes. 

The following examples demonstrate how you as the system's root user 
can run the fsck command to check the integrity of file systems- 

• To check a single unmounted file system, perform the command: 

1 fsck /dev/rdsk/c0toaOs7 

This is the only way to check a file system that has not been entered 
in the / etc /vf stab file, 

• To check a file system using the mount point directory name as listed 
in the / etc /vf stab £Ue, perform the command: 

it fsck /eocport/home 

In the following example, the fsck command checks and repairs the file 
system with the force (f) and preen (p) options. 

# fsck -o f # p /dev7ndsk/c0t0d0s7 

/dev/rdsk/c0t0d0s7: 77 files, 9621 used, 46089 free 
/dev/rdsk/c0t0d0s7: (4 frags, 57 blocks, 0 . 0% fragmentation) 

The f option of the fsck command forces a file system check, regardless 
of the state of the file system's superblock state flag. 

The p option checks and fixes the file system nonmteractively (preen). The 
program exits immediately if a problem requiring intervention is found, 
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Resolving File System Inconsistencies 



If problems are located in a file system, you are alerted by the f sck utility. 
Some of the more common file system errors that require interactive 
intervention are: 

• Allocated unreferenced file 

• Inconsistent link count 

• Free block count corruption 

• Superb] ock corruption 

Reconnecting an Allocated Unreferenced File 



If the f sck command discovers aninode that is allocated but 
unreferenced or not linked in any directory, the command sends a 
message that asks you if you want to reconnect the inode. 

** Phase 3 - Check Connectivity 
UNEEF FILE 1=788 OWNER=root MODE=100644 
SIZE=19994 MTIME=Jan 18 10; 49 1999 
RECONNECT? y 

A yes response causes the f sck. command to save the file to the 

lost+ found directory. The fsck command references the inode number. 



To determine the type of file moved to the lost+f ound directory by the 
fsck command, perform the following steps: 

U List the contents of the file system's lost+ found directory 

1* Is / export /honie/ lost* found 

#788 

2* Determine the file type by using the file command, 

# file /e^rt/hcnra/lost+founa/#7S8 

/ export /home/ lost* f ound/#788 : ascii text 

3. To view the contents of an ASCII text file, use the more or cat 
command. To view the contents of a binary file, use the strings 
command, if the file is associated with an application, such as a 
word processing document, use the application to view the contents 
of the file. 

# cat /export /home/ lost +found/#788 
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4* If the file is intact and you know where it belongs, you can copy the 
file back to its original location in the file system. 

# ep /escort /home /lost + found/ #7 3 8 /export /home /userl/ report 



Adjusting a Link Counter 



If the f sck program discovers that the value of a directory inode link 
counter and the actual number of directory links are inconsistent, the 
command displays a message that asks you if you want to adjust the 
counter 

** Phase 4 - Check Reference Counts 
LINK COUNT DIR. 1 = 2 OWNER=root MDDE=40755 
SIZE=512 MTIME=Jan 18 15:59 1999 COUNT 4 SHOULD BE 3 
ADJUST? y 



111 ! 



m the example, a y (yes) response causes the fsck command to correct the 
directory inode link counter from 4 to 3/ 

During this phase, you might also be asked to clear or remove a link. 

BAD/DUP type 1=200 0WNER=root MODE=40755 
SIZE=512 MTIME=Mar 14 08:03 2002 
CLEAR? y 



Salvaging the Free List 



If the f sck utility discovers that the unallocated block cotint and the free 
block number listed in the superb lock are inconsistent, the f sck 
command display? a message that asks if you want to salvage the free 
block count by rectifying it with the unallocated block count. 

** Phase S - Check Cyl groups 

CG 0: BAD MAGIC NUMBER 

FREE BLK COUNT (S) WRONG IN SUPERBLK 

SALVAGE? y 



In the example, a y (yes) response causes the f sck command to update the 
information in the file system superblock. 
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Using Backup Superblocks 

Superblock corruption can cause a file system to be unmountable. A file 
system is unusable when the message such as "Can ' t mount 
file^systenLname" or "device_jiame is not this fs type" appears. 

Can't mount /dev/dsk/c0t0d0s7 



Tliis message can appear during a system boot or when you are manually 
mounting the file system. 

If the fsck command fails because of a corrupted superblock, you see an 
error message that tells you to execute the fsck command using a 
superblock backup to recover the file system. Execute the fsck command 
with the -o option and with the b flag followed by a backup superblock 
number. Every file system has an alternative backup superblock at block 
number 32, which can be used with the fsck command to repair the 
primary superblock. 

The following command uses a backup superblock, 

# fsck -o b»32 /dev/rdsk/c0t0d0s7 

Alternate super block location? 32. 

** /dev/rdsk/c0t0d0s7 

** Last Mounted on 

** Phase 1 - Check Blocks and Sizes 

** Phase 2 - Check Pathnames 

** Phase 3 '■ Check Connectivity 

** Phase 4 - Check Reference Counts 

** Phase 5 - Check Cyl groups 

2 files, 9 used, 5174880 free (16 frags, 646858 blocks, 0.0% 

f ragmen t a t i on ) 

# 



The fsck utility compares the information in the backup superblock with 
the actual file system and attempts to rebuild the primary superblock. 
However, if the first backup superblock is part of the file system that was 
damaged, it may be unusable. Select another backup superblock to 
continue the fsck command. 



To list the locations of all the alternative backup superblocks in the file 
system, run the newfs -N command. 
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A 



Caution - This method works i/ the underlying file system was built 
using the newf s default parameters. If the file system was not built with 
these defaults, execute the newf s -N command, using the same 
parameters originally used, to generate identical superbloek locations. 

Use the -M option to view the file system parameters that you cottld use to 
create a new file system without actually creating the file system. A 
portion of the output is a list of the locations of all the alternative backup 
superblocks that can be used with the fsck -o b=# command. 

# newfs -N /dev/rdsk/c0t0d0s7 

/dev/rdsk/c0t0dQs7 j 10510856 sectors in 2927 cylinders of 27 tracks, 

133 sectors 

5132.3MB in 183 cyl groups (16 c/g, 28,05MB/g, 3392 i/g) 
super -block backups (for fsck -F ufs -o b=#) at: 

32, 57632, 115232, 172832, 230432, 283032, 345632, 403232, 460832, 
518432,576032, 633632, 691232, 748832, 806432, 864032, 921632, 979232 
(output truncated) 
# 



You can use any other alternative superbloek number in the list with the 
fsck command* 



# fsck -o b=535952 /dev/rdsk/c0t0d0s7 

Alternate super block location: 518432 
** /dev/rdsk/c0t0d0s7 
** Last Mounted on 
** Phase 1 - Check Blocks and Sizes 
** Phase 2 - Check Pathnames 
** Phase 3 - Check Connectivity 
** Phase 4 - Check Reference Counts 
** Phase 5 - Check Cyl groups 

7 files, 14 used, 279825 free (17 frags, 347891 blocks, 0.0% fragmentation) 

*****FILE SYSTEM VJAS MODIFIED* * * * * 

If 
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Monitoring File System Use 

An important activity of a system administrator is to monitor file system 
use on a regular basis. There are three useful commands available for this 
task: 

• df - Displays the number of free disk blocks 

• du - Summarizes disk use 

• quot - Summarizes file system ownership 



Using the df Command 



I 111 



Use the df command to display the amount of disk space used in file 
systems. This command lists the amount of used and available space and 
the amount of the file system's total capacity being used. 



The format for the df command is: 

df -option mount _s>oint 



Table 3-1 lists some of the more common options used with the df 



command. 



Table 3-1 


Partial Listing of Options for the df Command 


Option 


Descriptioii 


-a 


Reports on all file systems, including those with entries in 
the /etc/rmittab file for which the ignore option is set 


fb 


■Prints the total number of Kbytes tree 


-e 


Prints only the number of files free 


-k 


Displays disk allocation in Kbytes 


-h 


Acts like the -k option, except that sizes are in a more 
readable format for example, 14K, 234M, 2 . 7G, or 3 . OT 


-1 


Reports on local file systems only 
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To display the capacity of file systems, perform the command: 

# df -k 



Filesystem 


kbytes 


used 


avail 


capacity 


Mounted cm 


Zdev/dsk/cOtOdOsO 


114000 


69446 


33154 


68% 


/ 


/dev/asK/c0cQaUs6 


1280269 


990963 


238096 


81% 


/usr 


/proc 


0 


0 




0% 


/proc 


mnttab 


0 


0 


0 


0% 


/etc/mnttab 


fd 


0 


0 


0 


0% 


/dev/fd 


Zdev/dsk/cOtOdOsl 


54861 


45062 


4313 


92% 


/var 


swap 


683232 


48 


683184 


1% 


/var/run 


swap 


683184 


0 


683184 


0% 




/dev/dsk/c0t0d0s5 


24114 


550 


21153 


3% 


/opt 


/dev/dsk/c0t0d0s7 


2101887 


92 


2038739 


1% 


/export /home 



The same file system displayed with the -h option would appear in 
human-readable format 



# df -h 








':- 




Filesystem 


size 


used 


avail 


capacity 


Mounted on 


Zdev/dsk/cOtOdOsO 


111M 


68M 


32M 


68% 


I/TP J\ X * 


/dev/dsk/c0t0d0s6 


1.2G 


968M 


23 3H 


81% 


/usr 


/proc 


OK 


OK 


OK 


0% 


/proc 


mnttab 


OK 


OK 


• OK 


0% 


/etc/mnttab 


fd 


OK 


OK 


OK 


0% 


/dev/fd 


/dev/dsk/c0t0d0sl 


54M 


44M 


4.2M 


92% 


/var 


swap 


667M 


48K 


6673* 


1% 


/var/run 


swap 


667M 


OK 


S67M 


0% 


tmp 


/dev/dsk/c0t0d0s5 


24M 


550K 


S 21M 


3% 


/opt 


/dev/dsk/c0t0d0s7 


2.0G 


92K 


1.9G 


1% 


/export /home 



Table 3-2 defines the fields displayed by the df ~k command. 
Table 3-2 Fields for the df -k Command 



Held 


Definition 


Filesystem 


The mounted file system 


kbytes 


The size of the file system in Kbytes (1024 bytes J 


used 


The number of Kbytes used 


avail 


The n timber of Kbytes available 


capacity 


The percentage of file system capacity used 


Mounted on 


The mount point 
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The amount of space that is reported as used and avail is typically less 
than the amount of total space in the file system. A fraction of space, from 
1 to 10 percent; is reserved in each file system as the minf ree value. 

When all of the reported space on the file system is in use, the file system 
capacity is displayed as 100 percent. Regular users receive the message 
"File System Full" and cannot continue working. The reserved space 
is available to the root user, who can then delete or back up files in the 
file system. 



Use the du command to display the number of disk blocks used by 
directories and files. Each disk block consists of 512 bytes. 

The format for the du command is: 



Using the du Command 



Mb 



du -options directory 




Option Description 



-k Displays disk use in Kby tes. 



-s: Displays only the summary in 512-byte blocks. Using the s 

and k options together shows the summary in Kbytes. 



-a Displays the number of blocks used by all files in addition to 

Directories within the specified directory hierarchy 



To display disk usage in kilobytes, perform the command: 



# cd /opt 

# du -k 

8 . /lost+ found 

3 . /SUNWits/Graphics-sw/xil/lib 

4 . /SUWWits /Graphics- sw/xil 
7 . / SUKEWr tvc / man /man 1 
{some output removed for brevity) 
19 . /SUNWrtvc/man /man3 

27 ./StJWWrtvc/man 
535 , /SUNWrtvc 

550 
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To display disk usage including files, perform the command: 

| du -ak /opt 

8 /opt/lost+found 

1 / opt /SUNWits / Graphics -sw/xi 1 / lib/ libxil . s o 

1 / opt / SUNWi ts /Graphics -sw/xil / lib/ libxil . so . 1 

3 /opt / SUNWi ts /Graphics -sw/xil / lib 

(some output removed for brevity) 

27 /opt/SUNWrtvc/man 

535 /opt/SUNWrtvc 

550 /opt 

To display only a summary of disk usage, perform the command: 



# du -sk /opt 

550 /opt 



Using the quot Command 




Use the quot command to display how much disk space, in kilobytes, is 
being used by users. 



Note - The quot. command can be run only by the root user. 



The format for the quot command is: 



quot -options file&ystem 



Table 3-4 describes the options for the quot command. 
Table 3-4 Options for the quot Command 



Option 


Description 




Reports on all mounted file systems 


-f 


Includes the number of files 
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To display disk space being used by users on all mounted file systems, 
perform the command: 



ft quot -af 






Zdev/rdsk/cOtOdOsO 


(/) : 


14326 


1284 


root 


4792 


37 


bin 


31 


27 


lp 


1 


1 


sys 


/dev/rdsk/c0t0d0s6 


( /usr) : 


197394 


6962 


root 


161203 


1I8S4 


bin 


2140 


232 


lp 


1 


1 


adm 



The columns represent kilobytes used, number of files, and owner, 
respectively 

To display a count of the number of files and space owned by each user 
for a specific file system, enter the following: 



1 quot -f /derv7dsk/c0t0d0s7 

/dev/dsk/c0t0d0s7 ; 

134 62 root 
103 84 userl 
140 32 user9 



Using the Solaris Management Console Usage Tool 

The Solaris Management Console Usage Tool provides a graphical display 
of the available space for all mounted file systems, 

To use the Solaris Management Console storage Usage Tool, launch the 
Solaris Management Console by typing amc& at a command line, or select 
it from the Application Manager Window. To locate the Usage Tool, select 
This Computer, then select Storage, then select Mounts and Shares on the 
Solaris Management Console. 
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Figure 3-8 shows the Management Tools: Solaris Management Console 
window with the disk usage information. 
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Figure 5-8 Management Tools: Solaris Management Console Window 
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Performing the Exercises 

You have the option to complete any one of three versions of a lab. To 
decide which to choose, consult the following descriptions of the levels: 

• Level 1 - This version of the lab provides the least amount of 
guidance. Each bulleted paragraph provides a task description, but 
you must determine your own way of accomplishing each task. 

• Level 2 - This version of the lab provides more guidance. Although 
each step describes what you should do, you must determine which 
commands (and options) to input 

• Level 3 - This version of the lab is the easiest to accomplish because 
each step provides exactly what you should input to the system. This 
level also includes the task solutions for all three levels. 
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Exercise: Creating and Maintaining ufs File Systems 
(Level 1) 

In this exercise, you complete the following tasks: 

• Create ufs file systems 

• Calculate and adjust minf ree values 

• Destroy the superb lock on an unused file system and repair it using 
an alternative 

Preparation 

This exercise requires an unused disk divided into four slices. Slices 0, 1, 
and 3 are equal in size, and Slice 4 takes up die remaining space on the 
disk, If it is necessary to partition the disk, this exercise requires an 
understanding of how to use the f ormat utility Refer to the lecture notes 
as necessary to perform the steps, 



Tasks 




Perform the following tasks: 

• Find a disk that is not in use and that is partitioned as specified in 
the preceding preparation description. If necessary, partition a disk 
accordingly. Create a new file system on Slice 0. Create a file system 
on Slice 1 with an inode ratio of 1 per 16384 bytes of data space. 
Compare how quickly the newf s command makes the file systems. 
For both file systems, record the number of cylinder groups, the 
number of cylinders per group, and the number of inodes per group, 
How do the file systems differ? 

(Steps 1-6 in the Level 2 lab) 

m Display the number of Kbytes used, the number available, and the 
number allocated to both file systems, Record these values. Which 
tile system has more available space and why? For each file system, 
calculate how much larger the Kbytes value is than the sum of the 
used and available values, and express the result as a percentage. 
Use the f styp command to verify the result. 

(Steps 7-8 in the Level 2 lab) 




3-30 Intermediate System Administration for the Solaris™ 9 Operating Environment 

Copyright 2003 Sun Microsystems, Inc. All Rights Reserved. Sun Services, Revision A.2 



Exercise: Creating and Maintaining ufs File Systems (Level 1 ) 



• Adjust the minfree value up or down by 3 percent. Record the 
message that your command displays. Verify the change made by 
using the tunef s command, 

(Steps 9-10 in the Level 2 lab) 

• Create new file systems on Slices 3 and 4 of your spare disk, 
(Step 11 in the Level 2 lab) 

• Check the file system on Slice 3 with the f sck command, and record 
if it reports any errors. Use the dd command from Step 13 in the 
Level 2 lab to destroy the primary super block of the new file system. 
Run the f sck command, and see Lf you get an error Use the f sck 
command and the backup superblock found at Sector 32 to repair the 
file system and main superblock. Verify the repair by running the 

f sck command again. 

(Steps 12-16 in the Level 2 lab) 
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Exercise: Creating and Maintaining uf s File Systems 
(Level 2) 



In this exercise, you complete the following tasks: 

• Create uf s file systems 

• Calculate and adjust minfree values 

m Destroy the superb lock on an unused file system and repair it using 
an alternative 



This exercise requires an unused disk, divided into four slices. Slices 0, 1, 
and 3 are equal in size, and Slice 4 takes up the remaining space on the 
disk. If it is necessary to partition this disk, this exercise requires an 
understanding of how to use the format utility Refer to the lecture notes 
as necessary to perform the steps. 



In this exercise, you accomplish the following: 

• Find a disk that is not in use and that is partitioned as specified in 
the preceding preparation description. If necessary, partition a disk 
accordingly Create a new rile system on Slice 0. Create a file system 
on Slice 1 with an inode ratio of 1 per 16,384 bytes of data space. 
Compare how quickly the newf s command makes the file systems. 
For both file systems, record the number of cylinder groups, the 
number of cylinders per group, and the number of inodes per group. 
How do the file systems differ? 

• Display the number of Kbytes used, the number available, and the 
number allocated to both file systems. Record these values. Which 
file sv stem has more available space and why? For each file system, 
calculate how much larger the Kbytes value is than the sum of the 
used and available values, and express the result as a percentage. 
Use the f styp command to verify 7 the result. 

• Adjust the minfree value up or down by 3 percent. Record the 
message that your command displays. Verify the change made by 
using the tunefs command. 



Preparation 




Task Summary 
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• Create new file systems on Slices 3 and 4 of your spare disk, 

# Check the file system on Slice 3 with the f sck command, and record 
if it reports any errors. Use the dd command from Step 13 in the 
Level 2 lab to destroy the primary superb lock of the new file system. 
Run the f sck command, and see if you get an error. Use the t sck 
command and the backup superb lock found at Sector 32 to repair the 
file system and main superb lock. Verify the repair by running the 

f sck command again, 

Tasks 

Complete the following steps: 

1. Log in as the root user, and open a terminal window. Change the 
directory to / dev/rdslc 

2. To find a spare disk, use the Is command to display a list of possible 
disks and the prtvtoc command to display the VTOC for each disk 
you find- Examine the partition list as well as the Mount Directory 
field that the prtvtoc command displays. Disks that are not in use 
have no mount directory listed. Record the name of the unused disk, 

Unused disk: 

' ' 

Note - This procedure \vorks for the classroom emironment. A disk that 
not show mounted slices in £he Mount Directory field of the prtvtoc 
ut is not necessarily inactive. 



If a spare disk exists but it is not divided into four slices, use the 
format utility to partition the disk. Make three slices exactly the 
same size (approximately 25 percent of the total disk space each); 
and use the fourth partition for the remainder of the available space. 
Exit from the format utility when you are finished* You can also use 
the Solaris Management Console to partition the drive. 

Use the newf s command without options to create a new file system 
on Slice 0 on the spare disk. Observe how quickly the newf s 
command creates cylinder groups on this slice. Record the number of 
cylinder groups, the number of cylinders per group, and the number 
of modes per group. 

Cylinder groups: 

Cylinders per group: 

Inodes per group: 





3. 
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5. Use the newf s command to create a new file system on Slice 1 on the 
spare disk. Use the -i option to create one inode per 16,384 bytes of 
data space. Observe how quickly the newfs command creates 
cylinder groups on this slice. Record the number of cylinder groups, 
the number of cylinders per group, and the number of modes per 
group. 

Cylinder groups: 

Cylinders per group: 

modes per group: 

6* According to the statistics you have gathered, how do the hie 
systems on Slices 0 and 1 differ? 

7. Use the df command to display statistics for the file systems on 
Slices 0 and 1 that you used in the previous steps. Record the values 
listed in the kbytes, used, and avail columns. 

Which file system has the larger amount of available data space and 
why? 

8. For each file system, add the used and avail values, and compare 
the sum to the kbytes value* Expressed as a percentage, how much 
larger is the kj^ytes value than the sum of used and avail? This 
percentage should approximately match the minfree value. 

Use the f styp command to verify your result. 

9. Use the tunefs command to change the minfree value for the file 
system on Slice 0 of the spare disk. If the current minfree value is 
greater than 5 percent reduce it by 3 percent. If it is less than or 
equal to 5 percent, add 3 percent, 

What message does the tunefs command display? 

1CL Use the df -k command to verify that the minfree value has 
changed. Record the values listed in the kbytes, used, and avail 
columns. 

Which value has changed from the information vou gathered in 
Step 7? 

11, Create new file systems on Slices 3 and 4 of your spare disk. 

12. Run the f sck command interactively to check the new file system 
previously created on Slice 3 of the spare disk. 

Did the f sck command report errors? 
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13. Use the dd command to destroy the main superb lock of the file 
system on Slice 3. 

# dd if=/dev/zero of =/dev/rdsk/clt0d0s3 count=32 bs=:512 

14. Run the f sck command interactively to check the new file system. 

Did the f sck command report errors? If so, what corrective action 
does the f sck command suggest? 

15. Run the f sck command, and specify an alternative superb lock, 
["lock 32 is always cine of the alternatives available. 

16. Run the f sck command again to verify that the file system was 
repaired. 
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Exercise: Creating and Maintaining uf s File Systems 
{Level 3) 

In this exercise, you complete the following tasks: 
m Create uf s file systems 

• Calculate and adjust itiinf ree values 

m Destroy the superblock on an unused file system and repair it using 
an alternative 

Preparation 

This exercise requires an unused disk, divided into four slices, Slices G, I, 
and 3 are equal in size, and Slice 4 takes up the remaining space on the 
disk. If it is necessary to partition this disk, this exercise requires an 
understanding of how to use the format ..-utility. Refer to the lecture notes 
as necessary to perform the steps ► 

Task Summary 

In this exercise, you accomplish the following: 

• Find a disk that is not in use and that is partitioned as specified in 
the preceding preparation description. If necessary, partition a disk 
accordingly. Create a new file system on Slice 0. Create a file system 
on Slice 1 With an mode ratio of 1 per 16,384 bytes of data space. 
Compare how quick] y the newf s command makes the file systems. 
For both file systems, record the number of cylinder groups, the 
number of cylinders per group, and the number of modes per group. 
How do the file systems differ? 

• Display the number of Kbytes used, the number available, and the 
number allocated to bom file systems. Record these values* Which 
file system has more available space and why? For each file system, 
calculate how much larger the Kbvtes value is than the sum of the 
used and available values, and express the result as a percentage. 
Use the fstyp command to verify the result. 

• Adjust the mi n free value up or down by 3 percent. Record the 
message that your command displays. Verify the change made by 
using the tunef s command. 
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• Create new file systems on Slices 3 and 4 of your spare disk, 

• Check the file system on Slice 3 with the f sck command, and record 
if it reports any errors. Use the dd command from Step 13 in the 
Level 2 lab to destroy the primary superblock of the new file system. 
Run the f sck command, and see if you get an error. Use the f sck 
command and the backup superblock found at Sector 32 to repair the 
file system and main superblock. Verify the repair by running the 

f sck command again. 



Tasks and Solutions 



Complete the following steps: 

1 . Log in as the root user, and open a terminal window, Change the 



directory to /dev/rdsk. 



# cd /dev/rdsk 



To find a spare disk, use the Is command to display a list of possible 
disks and the prtvtoc command to display the VTOC for each disk 
you find. Examine the partition list as well as the Mount Directory 
field that the prtvtoc command displays. Disks that are not in use 
have no mount directory listed. Record the name of the unused disk. 



Is »s2 
prtvtoc 



/dev/rdsk/clt 0dOs2 

Unused disk: 




Note * This procedure works for the classroom environment. A disk that 
does not show mounted slices in the Mount Directory field of the prtvtoc 
output is not necessarily inactive. 



Part Tag 

0 alternates 

1 alternates 

2 backup 

3 alternates 

4 alternates 



If a spare disk exists, but it is not divided into four slices, use the 
format utility to partition the disk. Make three slices exactly the 
same size (approximately 25 percent of the total disk space each), 
and use the fourth partition for the remainder of the available space. 
You can also use the Solaris Management Console to partition the 
drive. Exit from the format utility when you are finished. 

Example of the partition table: 

Flag Cylinders Size 

wm 0 - 1168 2.00GB 

wm 1169 - 2337 2.00GB 

wm 0 - 4923 8.43GB 



wm 

wm 



2338 
3507 



3506 
4922 



2.00GB 
2.42GB 



Blocks 
(1169/0/0) 4197879 
(1169/0/0) 4197879 
(4924/0/0) 17682084 
{1169/0/0) 4197879 
(1416/0/0) 5084856 
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4, Use the newf s command without options to create a new file system 
on Slice 0 on the spare disk. Observe how quieklv the newf s 
command creates cylinder groups on this slice. Record the number of 
cylinder groups, the number of cy linders per group, and the number 
of mode? per group. 

# newf s /dev/rdek/cltOdOsO 

Cylinder groups: 
Cylinders per group: 
Inodes per group: 

5. Use the newf s command to create a new file system on Slice 1 on the 
spare disk. Use the - i option to create one inode per 16,384 bytes of 
data space- Observe how quickly the newf s command creates 
cylinder groups on this slice. Record the number of cylinder groups, 
the number of cylinders per group, and the number of inodes per 
group, 

# nmfe -i 16384 /dev/rdsk/cltOdOsl 

Cylinder groups: 

• . I W % K 

Cylinders per group; 
Inodes per group: 

6. According to the atari sties you have gathered, how do the file 
systems on Slices 0 and 1 differ? 

The number of inodes per group is less on File Si/stem 1 than on File 
System 0, 

7, Use the df command to display statistics for the file systems on 
Slices 0 and 1 that you used in the previous steps, for example: 

# df -k Zdev/dfik/citOdOsO 

Filesystein kbytes used avail capacity Mounted on 

Zdev/dsk/cltOdOsO 8705501 9 8618436 0% 
ft df -k /dev/dsk/cltOdOsl 

Filesystem kbytes used avail capacity Mounted on 

/dev/dsk/cltOdOsl 8769565 9 8681796 0% 

Record the values listed in the kbytes, used, and avail columns. 

Which fiJe system has the larger amount of available data space and 
why? 

File System I has the larger amount of available data space because it holds 
fewer mode records. 
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8. For each file system, add the used and avail values, and compare 
the sum to the kbytes value. Expressed as a percentage, how much 
larger is the kbytes value than the sum of used and avail? This 
percentage should approximately match the minf ree value. 

Usethefstyp -v /dev/rdsk/c#t#d#s# | head -12 command to 
verify your result. 

To calculate the percentage difference between the sunt of used and avail 
ami the kbytes value, perform the following: 

a. Add the values listed as used and avail, for example: 
9 + 1926799 = 1926808 

b. Divide the sum of used and avail by the kbytes mine, for 
example: 

1926808 / 1986439 = 0.969981 

c. Multiply the result of Step b by 200, for example. 
0,969981 * 100 = 96.9981 111.. 

**** 

d. Subtract the result of Step c from 10(K for example: 
100 -96,9981 - 3.0019 

e. Round the result of Step, d to the nearest whole number, for example: 
3.0019 = 3 percent 

9. Use the tune fs ~m # 7dev/rdsk/c#t#d#s# command to change 
the rainf ree value for the file system on Slice 0 of the spare disk. If 
the current minf ree value is greater titan 5 percent, reduce it by 

3 percent. If it is less than or equal to 5 percent, add 3 percent, for 
example: 

# tunef s ~m 4 /dOT/rfsk/cltOdOfiO 

minimum percentage of free space changes from 1% to 4% 

What message does the tunef s command display? 
The minimum percentage of free space changes from x percent to x percent . 
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10. Use the df -k command to verify that the minfree value has 
changed. Record the values listed in the kbytes, used, and avail 
columns, for example: 

# df -k /dev/dsk/cltOdOsO 

Filesystem kbytes used avail capacity Mounted on 

/dev/dsk/cltOdOsO 8705501 9 8357271 0% 

Which value has changed from the information vou gathered in 
Step 7? 

The avail column changes but not the kbytes or used columns* 

11. Create new file systems on Slices 3 and 4 of your spare disk, for 
example: 

| nawf l /d#v/rdsk/clt0d0s3 
R newf s /dev/rdsk/clt0d0s4 

12. Run the f sck command interactively to check the new file system 
previously created on Slice 3 of the spare disk. 

Did the fsck command report errors? 

* i8L is iBL 

No, 

13. Use the dd command to destroy the main superb lock of the file 
system on Slice 3, 

# dd if=/dev/zero of = /deW rdflk/cltOd0s3 count ^3 2 bs=*512 

14. Run the fsck command interactively to check the new file s vstem . 

Did the fsck command report errors? If so, what corrective action 
does the f sck command suggest? 

The f sck command indicates that the magic number in the superb! ock is 
wrong and suggests repairing it by using an alternative superblock, for 
example: 

** /dev/rdsk/cit0d0s3 

BAD SUPER BLOCK: MAGIC NUMBER WRONG 

USE AN ALTERNATE SUPER- BLOCK TO SUPPLY NEEDED INFORMATION; 
e,g, fsck [-F ufs] -o b=# (special 

where # is the alternate super block. SEE fsck_ufs(lM) i 

15. Run the fsck command, and specify an alternative superblock. 
Block 32 is always one of the alternatives available* 

£ fsck -o b=32 /dev/rdsk/clt0d0s3 

16. Run the fsck command again to verify that the file system was 
repaired, 

I fsck /dev/rdsk/clt0dOe3 

77ns time the fsck command output does not report that the file sifstem 
was modified. 
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Exercise Summary 

Discussion - Take a few minutes to discuss what experiences, issues, or 
discoveries you had during the lab exercise. 

« Experiences 

• Interpretations 

• Conclusions 

• Applications 
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Performing Mounts and Unmounts 



Objectives 



Upon completion of this module, you should be able to: 
Identify mounting fundamentals 
Perform mounts 



Perform unmounts 

Access a mounted diskette or CD-ROM 
Restrict access to a mounted diskette or CD-ROM 
Access a diskette or CD-ROM without Volume Management 



The following course map shows how mis module fits into the current 
instructional goaL 

Managing Fife Systems 



the Solans™ 
QE Directory 
Hierarchy 



Managing 
Local Disk 
. Devices 



Managing 
the Solaris OE 
FHe System 



Performing 
Mounts and 
Unmounts 



Figure 4-1 Course Map 
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Working With Mounting Fundamentals 

In the Solaris OE, you use the mounting process to attach individual file 
systems to their mount points on the directory hierarchy, This action 
makes a file system accessible to the system and to the users. 

You use the unmounting process to detach a file system from its mount 
point in the directory hierarchy. This action makes a file system 
unavailable to the system or users. 

After you have created a file system by using the newts command, you 
must attach it to the Solaris OE directory hierarchy at a mount point, A 
mount point is a director}' that is the point of connection for a file system, 
File systems are commonly referred to by the names of their mount 
points, for example, the / (root) file system or the /usr file system. 
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Figure 4-2 shows how the director}' hierarchy spans from one file system 
to the next. 



-Tn°p" 



Qappli cationl 

Qappl i cati on 2 

— P~1 U3r = 

■ bin 

■ lib 

| sadm — ■— — 

dev L 

dsk , 

— | kerne 1 




etc 






de f a u 1 ■' 
var = 
a dm = 
export m 
home ■* 



/ (root) file system 
Zdev/dsk/cOtOdOsO 



/opt file system 

/dev/dsk/c0t0d0fl5 



/us r file system 



/dev/dsk/cOtGdOsG 



r/ejtport/homefi!esysterTi 
T/d^v / ds k /cOtOdOB 7 



us©r2 ■ tn^ 1 ■' ' 

p^| lISer3 rrriTiTT^ 

Figure 4-2 File Systems and Mount Points 

File systems do not contain their own mount point directories. 




Determining Which File Systems Are Currently 
Mounted 



You can determine which file systems are currently mounted hy using the 
mount command or the df command. 

The df command displays the amount of disk space occupied by 
mounted or unmounted file systems and, depending on the options used, 
displays both locally mounted and virtual file system information. 
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The mount command, which is located in the /usr/sbin directory, 
maintains a table of currently mounted file systems in the /etc /flint tab 
file. When the mount command is used without arguments, it lists all of 
the mounted file systems in the /etc/mnttab directory. When used with 
only a partial argument list, the command searches the / etc/ vf stab file 
for an entry that supplies the missing arguments, 



Note - While system administrators typically use the /usr/sbin /mount 
command, the system boot scripts use the /stain/mount command. 



Mounting a File System Automatically 





The Solaris OE provides several methods for automating file system 
mounts* 

The Solaris OE creates a default /etc/vf stab file during software 
installation, based on your selections. However, you can edit the 
/etc /vf stab file whenever file system entries need to be added or 
modified. 



Note - The automounter can mount network file systems on demand, 



Introducing the Virtual File System Table: /etc/vf stab 

The ./ etc/vf stab file lists all the file systems to be automatically 
mounted at system boot time, with the exception of the /etc/mnttab and 
/var/run file systems* 

The file format includes seven fields per line entry. By default, a tab 
separates each field, but any whitespace can be used for separators. The 
dash (-) character is used as a placeholder for fields when text arguments 
are not appropriate. Commented lines begin with the hash (#) symbol. 
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To add a line entry, you need the following information; 



device to mount 
device to fsck 

mount point 

FS type 
fsck pass 



mount at boot 



The device to be mounted. For example, a local ufs 
file system / dev/dsk/c#t#d#s#, or a pseudo file 
system /proc. 

The raw or character device checked by the file 
system check program (fsck) if applicable. A 
pseudo fiJe system has a dash (-) in this field. 

The name of the directory that serves as the attach 
mount point in the Solaris OE directory hierarchy, 

The type of file system to be mounted. 

Indicates whether the file system is to be checked 
by the fsck utility at boot time* A 0 (zero) or a 
nonnumeric in this field indicates no. A 1 in this 
field indicates the f sck : utility gets started for that 
entry and runs to completion. A number greater 
than 1 indicates that the device is added to the list 
of devices to have the fsck utility run. The fsck 
utility can run on up to eight devices in parallel. 
This field is ignored by the mountall command. 

Enter yes to enable the mountall command to 
mount the file systems at boot time. Enter no to 
prevent a file system mount at boot time. 



Note - For / (root), /usr, and /var (if it is a separate file system) file 
systems, the mount at boot field value is specified as no, The kernel 
mounts these file systems as part of the boot sequence before die 
mountall command is run. The mount command explicitly mounts the 
file systems / (root) and /usr as specified in the 

/etc / rcS ♦ d/ S3 Oroo tusr . sh script and the /var file system as specified 
in the / etc /rcS.d/S70buildmnttaJo script. 



mount options A comma-separated list of options passed to the 
mount command. A dash (-} indicates the use of 
default mount options. 
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Note - Because the default is to use tabs to separate the fields in the 
/etc /vf stab file, the fields often do not Line up under their respective 
headings. This can lead to some confusion when you axe viewing this file 
in a terminal window. 



An example of a / etc /vf stab file follows: 



/etc /vf stab 



device 
to fsck 



mount 
point 

/dev/fd 
/proc 



FS 
type 



# device 
#to mount 
# 

fd 

/proc 

Zdev/dsk/cOtOdOsl - 
/dev/dsk/cOtOdOsO /dev/rdsk/cOtOdOsO 
/dev/dsk/c0t0d0s7 Zdev/rdsk/c0t0d0s7 
swap / tnp tmpf s - 

# 



Introducing the /etc/mnttabFile 



fsck mount mount 
pass at boot options 




The /etc/mnttab file Is really an mntfs file system that provides 
read-only information directly from the kernel about mounted fUe 
systems on the local host, 

Each time a file system is mounted, the mount command adds an entry to 
this file. Whenever a file system is unmounted, its entry is removed from 
the /etc/mnttab file. 



Mount Point The mount point or directory name where the file 

system is to be attached within the / (root) file system 
( f o r exa mple, ,/usr, / op t ) , 

De\ r ice Name The name of the device that is mounted at the mount 
point. This block device is where the file system is 
physically located, 

Mount Options The list of mount options in effect for the file system. 

dev-n umber Thv major and minor device nunibor oi the mounted 
file system, 

Date and Time The date and time that the file system was mounted to 
Mounted the directory hierarchy. 
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The /var/run file system is a tmpf s mounted file system in the Solaris 
OE> It is the repository for temporary operating system files that are not 
needed across system reboots in this Solaris OE release. It is mounted as a 
pseudo file system rather than a disk-based file system. 

The /var/run directory requires no administration. For security reasons, 
it is owned by the root user. 

The /tmp directory continues to be a tmpf s mounted file system in the 
Solaris OE, It is the repository for temporary user and application files 
that are not needed across system reboots. It is a pseudo file system rather 
than a disk-based file system. 

The following examples show two ways to display currently mounted file 
systems. 

# more / etc /mnt tab 

Zdev/dsk/cOtOdOsO / ufs 

rw r intr, largefiles ,xattr , onerror=panic f suid, dev~2200000 1016466S 
25 

/proc /proc proc dev=4300000 1016466524 

mnttab /etc/mnttab mntfs dev=43cOQOO 1016466524 

fd /dev/fd fd rw,suxd,dev-4400000 1016466527 

swap /var/run tmpf s xattr.,dev=l 1016466529 

swap /tmp tmpfs xattr,dev=2 ; 1016466532 

/ dew dsk/cOt 0d0s7 / expor t / home ufs 

rw, intr, largefiles , xattr , onerror=panic , suid, dev^2200007 

1016466532 

-hosts /net autofs indirect , nosuid, ignore, nobrowse, dev=4 5 80001 
1016466537 

au to_home /home au to f s i ndi r ec t r i gnor e , nobr ows e , dev= 4580002 

1016466537 

-xfn /xfn: autofs indirect , ignore, dev=4 580003 1016466537 

sys41:vold(pid24B) /vol nfs ignore, dev= 4 540001 1016466554 

# mount 

/ on /dev/dsk/c0t0d0s0 

read/write/setuid/ intr/ largef iles/xattr/onerror=panic/dev^220 0000 on Mon Mar 18 
08:48:45 2002 

/proc on /proc read/write/ setuid/dev=430 0000 on Mon Mar 18 08:48:44 2002 
/etc/mnttab on mnttab read/write /setuid/dev=43c0000 on Mon Mar 18 08:48:44 2002 
/dev/fd on fd read/write/setuid/dev=4400000 on Mon Mar 18 08:48:47 2002 
/var/run on swap read/write/ settiid/>:attr/dev=l on Mon Mar 18 08:48:49 2002 
/tnp on swap read/write/setuid/xattr/dev=2 n. Mon Mar IS 08:48:52 2002 
/export/home on /dev/dsk/c0t0d0s7 

read/ write/setuid/ intr /largef iles/x^ttr/onerror=panic/dev^2200 007 on Mon Mar 18 
08:48:52 2002 
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Performing Mounts 

You can mount file systems manually by logging in as the root user and 
running the mount command, or the system can automatically mount file 
systems at boot time after consulting the / etc /vf stab file. 

Mounting a Local File System Manually 

The mount command not only lists which file systems are currently 
mounted, it also provides you, as the root user, with a method for 
mounting file systems, 

.; 'If, 

Default Behavior of the mount Command 

To mount a local file system manually, you need to know the name of the 
device when? the file system resides and its mount point directory name, 
Perform the command: 

# mount /dev/dsk/c0t0d0s7 /export /heme 

In this example, the default action mounts the file system with the 
following options: read /write, setuid, intr, nologging, and 
large files, xattr, and oner r or. 

The following list explains the default options for the mount command. 

read /write Indicates whether reads and writes are allowed on 
the file system. 

setuid Permits the execution of setuid programs in the 

file system. 

intr/nointr Allows and forbids keyboard interrupts to kill a 

process that is waiting for an operation on a locked 
file system. 

nologging Indicates that logging is not enabled for the uf s file 
system. 

large files All ows for the creation of files la rger than 2 Gbytes . 

A file system mounted with this option can contain 
files larger than 2 Gbytes. 

xattr Supports extended attributes not found in 

standard UNIX attributes. 
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Note - Due to file system overhead, the largest file size that can be created 
is approximately 866 Gbytes. 

onerror=act ion Specifies the action that the uf s file system should 
take to recover from an internal inconsistency on a 
file system. An action can be specified as; 

panic — Causes a forced system shutdown, This is 
the default- 
lock — Applies a file system lock to the file 
system. 

umount — Forcibly unmounts the file system. 



The /etc /vf stab file provides you:with another important feature. 
Because the /etc /vf stab file contains ihe mapping between the mount 
point and the actual device name, the root user can manually mount a 
file system specifying only the mount point on the command line. 

Using the mount Command Options 

When you are using mount options on the command line, remember that 
the options are preceded by the ^o flag. When you are using multiple 
options, enter them as a cotnnia -separated list following the -o flag. 

mount -o option, option, . , > device_naiue mount_point 



Note - Mount options are described in detail in the man page for the 
mount__ufs command. 



s mount /export /home 
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Some options used to mount local file systems include: ro, nosetuid, 
noatime, nolargef iles, and logging. 

• ro - Mounts the file system as read-only, 

The following is an example using this option on the command line: 

# mount -o ro /d©v/dsk/c0t0d0s6 /usr 

• nosuid - Prohibits the execution of setuid programs in the file 
system. This does not restrict the creation of setuid programs. 

The following example shows the use of multiple options on the 
command line: 

# Mount -o ro, nosuid / dev7 dsk/ c 0 1 OdO s 7 /export /home 

• noatime - Suppresses the time-last-accessed modification on inodes, 
which reduces disk activity on a file system where access times are 
not important. Specifying this option generally improves file access 
times and boosts overall performance, for example: 

if mount -o noatime / dev/ dsk / c Ot OdO s7 /astport /horoe 

• nolargef iles - Prevents a file system that contains one or more 
JJ Jar^c files" from beiiv^ mounted, tor example: 

# mount -o nolargef iles /dev/dak/cOtOdOs? / export /isome 

Use of the nolargef iles option fails if the file system to be 
mounted contains a large file or did contain a lar^e i'ile at i>m time 

If the file system currently contains a large file and the root user 
needs to mount it with this option, then the large file must be located 
and moved or removed from the file system. Then you must execute 
the fsck command manually to update the superblock information. 

The mount also fails if the file system at one time contained a large 
file, even though it was moved or removed. You must execute the 
fsck command to clear the old information and allow the file 
system to be mounted. 

• logging - Enables logging for a uf s file system, for example: 

# mount -o logging /dev/dsk/c0t0d0s7 /export/home 

UFS logging is a process of storing file system transactions or 
changes that make up a complete file or directory operation into a 
log before they are applied to the file system. After a transaction is 
stored, the complete transaction can be applied to the file system 
later. 

The UFS log is allocated from free blocks in the file system. It is sized 
approximately 1 Mbyte per 1 Gbyte, up to a maximum of 64 Mbytes, 
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As a UFS log readies its maximum size, it begins to write 
transactions to the file system. When the file system is unmounted, 
the entire UFS log is emptied, and all transactions are written to the 
file system- 

UFS logging offers two advantages. First, it prevents file systems 
from becoming inconsistent, therefore eliminating the need to rim 
lengthy f sck scans, Secondly, you can bypass f sck scanning, which 
reduces the time required to reboot a system if it was stopped by a 
method other than an orderly shutdown. 



Mounting All File Systems Manually 



The /etc /vf stab file is read by the / usr / sbin / rcoun tal 1 command 
during the system boot sequence and mounts all fiJe systems that have a 
yes in the mount at boot field. 

The root user can use the moun tall command to mount manually every 
file system in the /etc /vf stab file that has a yes in the mount at boot 
field, for example: 

ft mount all 

To mount only the local file systems listed in the /etc /vf stab file, 
execute: 

# mount all -1 




During the boot sequence, the f sck utility checks each local file system in 
the / etc /vf stab file that has a device to f sck entry and an f sck pass 
number greater than 0. The utility determines if the file system is in a 
usable state to be safely mounted. 

If the f sck utility determines that the file system is in an unusable state 
(for example, corrupted), the f sck utility repairs it before the mount is 
attempted. The system attempts to mount any local file systems that have 
a - (dash) or 0 (zero) entry in the f sck pass field without checking the file 
system itself. 
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Mounting a New File System 

To add a new disk to the system, prepare the disk to hold a file system, 
and mount the file system, perform these general steps: 

1 . Set up the disk hardware, which might include setting address 
switches and connecting cables, 

2. Perform a reconfiguration boot or run the devf sadm utility to add 
support for the new disk. 

3. Use the format utility to partition the disk into one or more slices. 

4. Create a new file system on one slice by using the newf s command. 

5. Create a mount point for the file system by using the mkdir 
command to create a new directory in the / (root) file system. 

$ mkdir /database 

6. Mount the new file svstem manually by using the mount command ► 
# mount Zdev/dsk/cltOdOsO /database 

7. Use the mount command to determine if the file system is mounted. 

I mount 

/ on /dev/dsk/cOtOdOsO 

r ead/ wr i t e / se tui d / int r / 1 ar gef iles/xattr/ oner r or =pani c / dev= 2200000 on Mon 
Mar 18 08:48:45 2002 

/proc on /proc read/write/setuid/dev-4300000 on Mon Mar 18 08:48:44 2002 
/etc/iranttab on mnttab read/write /setuid/dev=43c0000 on Mon Mar 18 
08:48:44 2002 

/dev/fd on fd read/write/setuid/dev=4400.000 on Mon Mar 18 08:48:47 2002 
/var/run on . swap read/write/setuid/xattr/dev=l on Mon Mar 18 08:48:49 
2002 

/tmp on swap read/write/setuid/xattr/dev^2 on Mon Mar 18 08:48:52 2002 
/export /home on /dev/dsk/c0tQd0s7 

r ead/ wr i te / setuid/ intr /largef i les /xat tr / onerror=panic /dev-22 00007 on Mon 
Mar 18 08:48:52 2002 
/database on /dev/dsk/clt0d0s0 

read / wr ite/setuid/ intr / largef iles /xat t r / onerror =pani c /dev- 8 0 0020 on Mon 
Mar 18 09:15:26 2002 
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8. Edit the /etc/vf stab file to add a line entry- for the new file system. 



# vi /etc/vf stab 










# device 


device 


mount 


FS 


fsck 


mount' mount' 


#to mount 
# 


to fsck 


point 


type 


pass 


at Knot - ont i on*; 


fd 




/dev/fd 


fd 




no 


/proc 




/proc 


proc 




no 


Zdev/dsk/cGtOdOsl - 




swap 




no 


/dev/dsk/cOtOdOsO Zdev/rdsk/cOtOdOsO 


/ ufs 


1 


no 


dev i d3k/c0t0d0s7 /dev/rdsk/c0tQdOs7 


/export /home ufs 


2 yes - 


swap 


/tmp 


tmpfs 


yes 






/dev/dsk/cltOdOsO /dev/rdsk/eltOdOsO 


/database 


ufs 1 


yes logging 



# 

The file system automatically mounts whenever the system boots. 

Mounting Different Types of File Systems 

Jf % * - 

Different file system types have unique properties that affect how the 
mount command functi ons. 

By default, the mount command assumes it is mounting a ufs-type file 
system. However, when you are mounting a different type of file system, 
vou might have to specify- its type on the command line, 

; ." \ \ : ? " 

You use the -F option -with the mount command to specify the type of file 
system mounted. The iile system type must be determinable from the 
/etc/vf stab, , etc/default/ fs ; or /etc/dfs/fstypes files. 

Determining a File System's Type 

Because the mount commands need the file system type to function 
properly, the file system type must be explicitly specified or determined 
by searching the following files: 

• The /etc/vf stab file for the FS type field 

• The /etc /default/ fs file for a local file system type 

• The /etc/dfs/fstypes file for a remote file system type 



Performing Mounts and Unmounts 

Copyright 2003 Sun Microsystems. Inc. AN Rights Reserved, Sun Services. Revision A.2 



4-13 



Performing Mounts 



If the file system's type has not been explicitly specified on the command 
line using the mount ~F FStype option, the mount command examines 
the /etc /vf stab file to determine the file system's type. The mount 
command makes this determination by using the file system's block 
device name, raw device name, or mount point directory name. 

If the mount command cannot determine the file system's type by 
searching the /etc /vf stab file, the mount command uses the default tile 
system type specified in either the /etc /def aul t / f s file or the 
/etc/df s/fstypes file, depending on whether the file svstem is local or 
remote. 



The default local file system type is specified in the ./etc /default / ts file 
by the line entry LOCAL=fst>pe. 

IXDCAL=ufs 

The first line entry in the /efcc/df s/ fs types file determines the default 
remote file system type, 

nfs NFS Utilities 
autofs AUTOFS Utilities 
cache fs CACHEFS Utilities 



Using the fstyp Command 

You can also use the fstyp command with the raw device name of the 
disk slice to determine a file system's type. 



| fstyp /dev/rdsk/c0t0d0s7 

uf s 



Specifying an hsfs File System Type 

To mount a file system that resides on a CD-ROM when the Volume 
Management services are stopped, as the root user perform the 
command: 

# mount -F hsfs -o ro /dev/dsk/cQtSdOsD /cdrom 

In this example, the file system type is hsf s, the file system resides on 
disk slice /dev/dsk/c0t6d0s0 r and the mount point /cdrom is a 
pre-existing director) 7 in the Solaris OE, 
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Specifying a pcfs File System Type 

To mount a file system that resides on a diskette when the Volume 
Management services are stopped, as the root user, perform the 
commands: 

# mkdir /pcfs 

?f mount -F pcfs /dev/diskette /pcfs 

In this example, the file system type is pcf s. This file system resides on 
the device /dev/ diskette, and the mount point is /pcfs. 
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Performing Unmounts 

A file system is commonly unmounted if it needs to be checked and 
repaired by the tsck command, or if it needs to be backed Lip completely, 



Unmounting a File System 

Some file system administration tasks cannot be performed on mounted 
r iit- systems. 

To unmount a file system to prepare it for system maintenance, use the 
umount command. 



Unmounting a file system by using the umount command removes it from 
the file system mount point and deletes its entry from the /etc/mnttab 
file. 



Note - Notify users before unmounting a file system mat they are 
/^Zjj^ currently accessing. 

To unmount a file system manually by using the directory mo tint point, 
perform the command: 

# umount /export /home 

To unmount a file system manually by using the logical disk device name, 
perform the command: 

# umount /0©v/dsk/c0toa0s7 



Unmounting All File Systems 



The /etc/mnttab file is read by the /usr/sbin/ umount all command 
during the system shutdown sequence or when umount all is invoked 
from the command line. The amount all unmounts all file systems 
specified in the vf stab file except / (root), /usr, /proc, /devV fd, /var, 
/var/run, and /tmp + 
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Run the umountall command as the root user when you want to 
unmount manually all the file systems listed in the /etc/mnttab file, for 
example: 

# -umountall 

To unmount only the local file systems listed in the /etc/mnttab file, 
perform the command: 

# umountall -1 

To verify that a hie system or a number of file systems have been 
unmounted, invoke the mount command and check the output. 

Unmounting a Busy File System 

Any file system that is busy if? not available for unmounting. Both the 
umount and umountall commands display the error message: 

umoun t : fil e„sys t em_name busy 

A file system is considered to be busy if one of the following conditions 
exists: 

• A program is accessing a file or directory in the file system 

• A user is accessing a directory or file in the file system 
m A program has a file open in that file system 

• The file is being shared 

There are two methods to make a file system available for unmounting if 
it is busy: - 

ft f user command - Lists all of the processes that are accessing the file 
system and kills them if necessary 

ft umount - f command - Forces the unmount of a file system 
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Note - The fuser command displays the process IDs of all processes 
currently using the specified file system. Each process ID is followed by a 
letter code. These letter codes are described in the man page for this 
command. 



Using the fuser Command 

To stop all processes that are currently accessing a file system, follow 
these steps: 

L As the root user, list all of the processes that are accessing the file 
system. Use the following command to identify which processes 
need to be terminated. 

| fuser -cm mount _point 

This command displays the name of the file system and the user 
login name for each process currently active in the file system, 

2. Kill all processes accessing the file system, 
± fuser -ck mount_point 

A SIGKILL message is sent to each process that is using the file 
system. 

3. Verify that there are no processes accessing the file system, 
# fuser -c moxmt_point 

4. Unmount the file system, 
h umount mount^point 

Using the umount -f Command 

As the root user, you can unmount a file system, even if it is busy by 
using the -f (force) option with the umount command. The following is 
the format for this command: 

| umount -f mount _point 

The file system is unmounted even if it contains open files. A forced 
unmount can result in loss of data and in zombie processes that are left 
running on the system. However, it is particularly useful for unmounting 
a shared file system if the remote file server is nonfunctional. 
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Repairing Important Files if Boot Fails 



The following procedure describes how to boot from the Solaris OE 
Software CD-ROM to edit a misconfigured / etc /vf stab file, 

1. Insert the Solaris 9 OE Software I of 2 CD-ROM into the CD-ROM 
drive, 

2. Execute a single-user boot from the CD-ROM. 



ok boot cdrotti -s 

Boot device: /pci@lf , 07pci@l, l/ide@3/cdrom@2, 0: f File and args -s 
SunOS Release 5*9 Generic 64 bit 

Copyright 1983-2002 by Sun Microsystems, Inc. All rights reserved. 
Configuring /dev and /devices 
Use is subject to license terms 

Using RPC Bootparams for network configuration information. 
Skipping interface hmeO 



% Use the fsck command on the / (root) partition to check and repair 
any potential problems in the file system. 

# £sck /deWrdsk/cOfcOdOsQ 

4. ff the fsck command is successful, mount the / (root) file system on 
the /a directory to gain access to the file system on disk. 

# mount /dev/dsk/cOtOdOsQ /a 

5. Set and export the TERM variable, which enables the vi editor to 
work properly. 

# TEFM=sun 

# export TERM 



INIT: SINGLE USER MODE 






6. 



Edit the /etc /vf stab file, and correct any problems. Then exit the 



file. 



# vi /a/ etc /vf stab 
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7\ Unmount the hie system, 

# cd / 

" umount /a 

S. Reboot the system. 

# init 6 
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Accessing Mounted Diskettes and CD-ROMs 

To provide access to file systems on diskettes and CD-ROMs, the Solaris 
OE provides users a standard interface referred to as Volume 
Management, 



Note - The Solaris 9 OE includes support for additional removable media 
such as DVDs, Jaz drives, Zip drives, and PCMCIA memory cards. 
(PCMCIA stands for Personal Computer Memory Card International 
Association.) For more information on using these devices, see the 
resources available on the Solaris 9 Documentation CD. 



Volume Management provides two major benefits: 

• It automatically mounts removable media for both the root user and 
non-root users. 

• It can give other systems on the network automatic access to any 
removable media currently inserted in the local system. 

The Volume Management service is controlled by the /usr/sbin/vold 
daemon. By default, this service is always running on the system so that it 
can automatically manage diskettes and CD-ROMs for regular users, 



Volume Management features automatic detection of CD-ROMs. 
However, it does not detect the presence of a diskette that has been 
inserted in the drive until the vol check command is run. Tnis command 
instructs the void daemon to check the diskette drive tor any inserted 
mediae Volume Management can mount ufs, pcfs, hsfs, and udf s file 
systems. 
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Using Volume Management 

To make working with diskettes and CD-ROMs simple for your users, 
each device is easy to mount and mounts at an easy-to-remember 
location. 

If the void daemon detects that the mounted device contains a file 
system, then the device is mounted at the directory location. 

Table 4-1 lists the directory locations of mounted devices that contain file 
systems. 

Table 4-1 Director}' Locations 



Media Device 


Access File Systems On 


First diskette drive 


/ floppy/' f loppy 0 


First CD-ROM or DVD 
drive 


/ cdrom/ cdromO 


First Jaz drive 


/rmdisk/ jasO 


First Zip drive 


/rrodrive/ zipO 


First PCMCIA card 


/pcmernO 



If the void daemon detects that the mounted device does not contain a 
file system, the device is accessible through a path. 

Table 4-2 lists the paths for mounted devices that do not contain file 
systems. 



Table 4-2 Paths for Accessing Devices 



Media Device 


Access Raw Device On 


First diskette drive 


/vol/dev/ aliases /floppyO 


First CD-ROM or DVD 
drive 


/vol/ dev / al iases / cdromO 


First Jaz drive 


/ vol / dev /aliases/ j az 0 


First Zip drive 


/vol /dev/aliases / z ipO 


First PCMCIA card 


/ vol / dev / aliases / pcmemO 
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When Volume Management is running on the system, a regular user can 
easily access a diskette or CD-ROM by following these basic steps: 

1. Insert the media. 

2* For diskettes only, enter the vol check command, 

3. Use the cd command to change to the directory of the mounted 
volume* 

4. Work with files on the media, 

5. Use the cd command to leave the directory structure of the mounted 
volume. 

6. Eject the media. 

Table 4-3 shows the configuration files used by Volume Management 



Table 4-3 Volume Management Configuration Files 



File 


Description 


/ etc /void, conf 


The Volume Management 
configuration file. This file defines 
items, such as what action should be 
taken when media is inserted or 
ejected, which devices are managed 
by Volume Management, and which 
file system types are unsafe to eject. 


/etc/ rmmount . conf 


The rmmount command configuration 
file. The rrnmount command is a 
removable media mounter that is 
executed by the Volume Management 
daemon whenever a CD-ROM or 
diskette is inserted, 
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Restricting Access to Mounted Diskettes and CD-ROMs 

To restrict regular users from accessing diskettes or CD-ROMs on the 
system, you can, as the root user, terminate the Volume Management 
service. 



Stopping Volume Management 

To stop Volume Management from running on a system temporarily, as 
the root user perform the command: 

# /etc/init , d/volmgt stop 



To restart the Volume Management service, as the root user perform the 
command: 

# /etc/init.d/volmgt start 



Troubleshooting Volume Management Problems 

If a CD-ROM fails to eject from the drive, as the root user attempt to stop 
Volume Management. If this is -unsuccessful, kill the vo id daemon. 



# /etc/init .d/voljngt stop 

or as a last resort: 

# pkill -9 void 



Push the b ut ton on the system to eject the CD-ROM. The CD-ROM tray 
ejects. Remove the CD-ROM, and leave the tray out. Then restart the 
Volume Management service, 

# /et c/init . d/volmgt start 

Wait a few seconds, and then push the CD-ROM tray back into the drive. 
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Accessing a Diskette or CD-ROM Without Volume 
Management 

When Volume Management is not running, only the root user can mount 
and access a diskette or CD-ROM Follow these steps: 

1. Insert the media device. 

2. Become the root user. 

3. Create a mount point, if necessary. 

4. Determine the file system type. 

5. Mount the device by using the mo Lint options listed in the following 
sections. 

6. Work with hies on the media device, 
7* Unmount the media device. 



8. Eject the media device. 

9. Exit the root session. 

Using the mount Command 



To mount a file system that resides on a CD-ROM when the Volume 
Management services are stopped, as the root user, perform the 
command: 

# mount -F hsfs -o ro /dev/dak / cO 1 6d0 & 0 /cdroro 

In this example, the file system type is hsfs, the file system resides on 
disk slice /dev/dsX/c0t6dQs0, and the mount point /cdrom is a 
pre-existing directory in the Solaris OE. 

To mount a file system that resides on a diskette when the Volume 
Management services are stopped, as the root user, perform the 
command: 

# mfedir /pcf s 

I mount -F pcf s /denr/diskette /pcf s 

In this example, the file system type is pcf s. This file system resides on 
the /dev/ diskette device, and the mount point used is /pcfs. 
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Performing the Exercises 

You have the option to complete any one of three versions of a lab. To 
decide which to choose, consult the following descriptions of the levels: 

• Level 1 - This version of the lab provides the least amount of 
guidance. Each bulleted paragraph provides a task description, but 
you must de tern-one your own way of accomplishing each task, 

• Level 2 - This version of the lab provides more guidance. Although 
each step describes what you should do, you must determine which 
commands (and options) to input, 

• Level 3 - This version of the lab is the easiest to accomplish because 
each step provides exactly what you should input to the system. This 
level also includes the task solutions for all tliree levels. 
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Exercise: Mounting File Systems (Level 1) 



In this exercise, you complete the following tasks: 

• Create mount points 

• Mount file systems 

m Specify mount options 



Preparation 



This exercise requires a spare disk that contains /our unmounted uf s file 
systems on Slices 0, 1, 3, and 4- Refer to the lecture notes as necessary to 
perform the tasks listed, 



• Record the default mount options that are used by the / (root) file 
system nun in ted on your system. Mount the file system found on 
Slice 4 of your spare disk on the /moras pace directory. Verify the 
mount options applied to the /morespace file system. 

(Steps 1-3 in the Level 2 lab) 

• Create a new file in the /mores pace file system that contains one line 
of text. Record the modify time for this file. Use the Is command to 
display the last access time for this file. Record the time value. Wait 
one minute, and then display the file content. Again check and 
record the last access time for this file. 

(Steps 4-7 in the Level 2 lab) 

• Unmount the /more space file system. Remount the same file system 
as /morespace, and use the noatime mount option. Again display 
the content of your text file. Check and record the last access time for 
it. Add a line to the / etc /vf stab file that mounts the /mo res pace 
file system when the system reboots. Reboot the system by using the 
reboot command, and verify that the /morespace file system is 
mounted. 

(Steps cMl in the Level 2 lab) 



Tasks 



Complete the following tasks: 
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* Mount the file system on Slice 0 as /dirO. Mount the file system on 
Slice 1 as /dirO/dirl. In a second terminal window, change to the 
/dirO/dirl directory. In the original terminal window, try to 
unmount the /dirO Adirl directory. Record the error messages. 
Attempt to forcibly unmount the / dirO /dirl directory, Record the 
result. Attempt to use the pwd command in the second terminal 
window. Record what happens, 

(Steps 12-17 in the Level 2 lab) 
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Exercise: Mounting File Systems (Level 2) 

In this exercise, you complete the following tasks: 

• Create mount points 

• Mount file systems 

• Specify mount options 



Preparation 



This exercise requires a spare disk that contains four unmounted uf s file 
systems on Slices 0, 1, 3, and 4. Refer to the lecture notes as necessary to 
perform the tasks listed. 



Task Summary 



In this exercise, you accomplish the following: 

• Record the default mount options that are used by the / (root) file 
system mounted On your system. Mount the file system found on 
Slice 4 of your spare disk on the /morespace directory Verify the 
mount options applied to the /morespace file system. 

« Create a new file in the /morespace file system that contains one line 
of text. Record the modify time for this file. Use the Is command to 
display the last access time for this file. Record the time value. Wait 
one minute, and then display the file content. Again check and 
record the last access time for this file. 

• Unmount the /morespace file system. Remount the same file system 
as ^morespace, and use the noatime mount option. Again display 
the content of your text file. Check and record the last access time for 
it. Add a line to the / etc /vf stab tile that mounts the /morespace 
file system when the system reboots* Reboot the system using the 
reboot command, and verify that the /morespace file system is 
mounted. 

• Mount the file system on Slice 0 as /dirO. Mount the file system on 
Slice 1 as /dirO/dirl. In a second terminal window, change to 
the/dirO/dirl directory. In the original terminal window, try to 
unmount the /dirO/dirl directory; Record the error messages. 
Attempt to forcibly unmount the /dirO/dirl directory, Record the 
result. Attempt to use the pwd command in the second terminal 
window. Record what happens. 
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Tasks 

Complete the following steps: 

L Log in as the root user, and open a terminal window. Use the mount 
command to list the file systems dial are currently mounted on your 
system. What are the default mount options applied to the / {root) 
file system? 

2. Create the directory /nvorespace to use as the mount point. 

3. Mount the file system on Slice 4 of your spare disk to the 
/rnorespace directory. Record the default mount options that were 
applied to this mount. 

4. Change to the /nvorespace director); and create a new file that has 
one line of content. 

5. Display a long listing for this file, and record the time value it 
reports. This time value represents when the fOe was last modi tied, 

6. Add the -u option to the is command to show when the file was last 
accessed. This time value is updated whenever you read the file, 

7. Wait one minute or more, and then use the cat command to display 
the file. Again check and record the access time. The access time 
should differ from the access time indicated in the previous step. 

8 + Change to the / (root) directory. Unmount the /rnorespace file 

system. Remount the same file system to the /rnorespace directory, 
but add the option that prevents update of access time values. Verify 
that the options to the mount were applied, 

9. Return to the /rnorespace file system, and use the cat command to 
display your test file. Again check and record the access time. The 
access time should match the access time that existed prior to your 
urutiounting and mounting the /rnorespace file system. 

10. Add a line to the /etc /vf stab file to make the mount for the 
/rnorespace file system happen when you boot the system, 

11. Reboot your system. Log in as the root user, and open a terminal 
window. Use the mount command to verify that the /rnorespace file 
system is mounted. 

12. Create a director} 7 called /dim Mo Lint the file system that resides on 
Slice 0 of your spare disk as /dirO. 

13. Create a director}' called / dirO/dirl. Mount the file system that 
resides on Slice 1 of your spare disk as /dirO/dirl. 
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14. Open a second terminal window. In this new window, change the 
directory to /dirO/dirl. 

15. In your original terminal window, attempt to unmount die file 
system mounted below the /dirO/dirl director) 7 ; Which message is 
displayed? Does the file system unmount? 



Note - To discover why you could not unmount the file system, use the 
fuser -cu /dirO/dirl command. The fuser command should show 



16, In your original terminal window, again attempt to unmount the file 
system mounted below the /dirO/dirl directory. Add the -f option 
to the umount command. Which message is displayed? Does the fUe 
system unmount? 

17. In the second terminal window, attempt to determine your current 
working directory. Which message displayed? Change the 
director}- to / (root), and verify that the pwd command works. 




the process ID of the shell 
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Tasks and Solutions 



Complete the following steps: 

1. Log in as the root user, and open a terminal window. Use the mount: 
command to list the file systems that are currently mounted on your 
system. What are the default mount options applied to the / (root) 
file system? 

I mount 

read / wr i te/ setuid/ intr / larger iles /xattr / onerror-panic / 
dev=2200000 

Your dev= number depends on the architecture of your system. 

2. Create the directory /morespace to use as the mount point. 
# mkdir /morespace 

% Mount the file system on Slice 4 of your spare disk to the 

/morespace directory Record the default mount options that were 
applied to this mount. 



# mount /dev/dsk/cltQd0s4 /morespace 
ft mount 

r ead/ wr i te / se tu id/ intr / larg e f i 1 e s / x a t : t r / one r r o r =pan ic / 
dev=80001c 



# cd /morespace 

# cat > testfile 

This is a test. 
<crtl> d 
# 



# is -1 



4. Change to the /morespace directory, and create a new file that has 
one line of content. 



# Is -lu 



Display a long listing for this file, and record the time value it 
reports; TO s time value represents when the file was last modified, 



Add the -u option to the Is command to show when the file was last 
accessed. This time value is updated whenever you read the file. 



7. Wait one minute or more, and then use the cat command to display 
the file. Again check and record the access time. The access time 
should differ from the access time indicated in the previous step. 



?i cat testfile 

This is a test 
ft Is -lu 
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Exercise: Mounting File Systems (Level 3) 

In this exercise, you complete the following tasks: 
i Create mount points 

• Mount file systems 

# Specif) 7 mount options 




Preparation 

: 

This exercise requires a spare disk that contains four unmounted ufs file 
systems on Slices 0, 1, 3, and 4, Refer to the lecture notes as necessary to 
perform the tasks listed. 

Task Summary 

In this exercise, you accomplish the following: 

• Record the default mount options that are used by the / (root) file 
system mounted on your system, Mount the file system found on 
Slice 4 of your spare disk on the /morespace directory. Verify the 
mount options applied to the /morespace file system. 

• Create a new file in the /morespace file system mat contains one line 
of text Record the modify time for this file. Use the Is command to 
display Lhe last access time for this file. Record the time yalue. Wait 
one minute, and then display the file content. Again check and 
record the last access time for mis hie, 

• Unmount the /morespace file system. Remount the same file system 
as /morespace, and use the noatime mount option, Again display 
the content of your text file* Check and record the last access rime for 
it. Add a line to the / etc /vf stab file that mounts the /morespace 
file system when the system reboots. Reboot the system using the 
reboot command, and verify that the /morespace file system is 
mounted. 

• Mount the file system on Slice 0 as /dirO. Mount the file system on 
Slice 1 as /dirO/dirl. In a second terminal window, change to the 
/dirO/dirl directory In the original terminal window, try to 
unmount the /dirO / dirl directory Record the error messages. 
Attempt to forcibly unmount the /dirO/dirl directory. Record the 
result. Attempt to use the pwcl command in the second terminal 
window. Record what happens. 
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8, Change to the / (root) directory Unmount the /morespace file 
system. Rem cum t the same file system to the /morespace directory, 
hut add the option mat prev ents update of access time values. Verify 
that the options to the mount were applied. 

I cd / 

ft uroount /morespace 

n mount -o noatime / dev/dsk/ c 1 1 OdO s4 /morespace 
# mount 

9, Return to the /morespace file system, and use the cat command to 
display your test file, Again check and record the access time. The 
access time should match the access rime that existed prior to your 
unmounting and mounting the /morespace file system, 

it cd /morespace 
= cat teat file 

This is a test 
if Is -lu 

10. Add a line to the / etc /vf stab fife to make the mount for the 
/morespace file system happen when you boot the system, 

/ dev/dsk/ clt OdO s 4 /dev/rdsk/clt0d0s4 /morespace ufs 2 yes noatime 

11. Reboot your system. Log in as the root user, and open a terminal 
window. Use the mount command to verify that the /morespace file 
system is mounted. 

. 



ft init 6 

(reboot messages & login prompts) 
* mount 

12. Create a directory called /dirO. Mount the file system that resides on 
Slice 0 of your spare disk as / dirO. 

ft mkdir /dirO 

ft mount /dev/dsk/cltOdOsO /dirO 



13. Create a directory called /dirO/dirl. Mount the file system that 
resides on Slice 1 of your spare disk as /dirO/dirl. 

1 mkdir /dirO/dirl 

ft mount /dev/dsk/citOdOsl /dirO/dirl 

14. Open a second terminal window. In this new window, change the 
directory to /dirO/dirl. 

# cd /dirO/dirl 
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15. In your original terminal window, attempt to unmount the file 

system mounted below the /dirO/dirl directory What message is 
displayed? Does the file system unmount? 

£ umaunt /dev/dsk/cltOdQsl 
U mount 

umount: /dirO/dirl busy 

The file system does not unmount. 




Note - To discover why you could not unmount the file system, use the 
fuser -cu /dirO/dii 1 command. The fuser command should show 
the process ID of the shell. 

16, In your original terminal window, again attempt to unmount the file 
system mounted below the /dirO/dirl director} - . Add the ~f option 
to the umount command. Which message is displayed? Does the file 
system unmount? 
k umoimt -f /dev/dsk/cltOdOfll 

'■■':\ 

# mount 

No messages are displayed . The file system un mounts. 

17* In the second terminal window, attempt to determine your current 
working directory Which message is displayed? Change the 
directory to / (root), and verify that the pwd command works, 

pwd 

Cannot determine current director*' 

# cd / 
ff pwd 

I Z\ f;.i\ : ^ M: i :. ^ 
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Exercise Summary 



Discussion - Take a few minutes to discuss what experiences, issues, or 
discoveries you had during the lab exercise, 

• Experiences 

• Interpretations 

• Conclusions 

• Applications 
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Module 5 



Installing the Solaris™ 9 Operating 
Environment 



Objectives 

Upon completion of this module, you should be able to: 

• Identify the fundamentals of CD-ROM installation 

• Install the Solaris™ 9 Operating Environment (Solaris 9 OE) from a 
CD-ROM 

The following course map shows how this module fits into the current 
instructional goal, 

Installing Software 



Installing the 
Solans™ 9 
OE 




Performing 
Solaris 9 QB 

Package 
Administration 




Managing 
Software 
Patches on 
the Sofaris 9 



Figure S-l Course Map 
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Identifying the Fundamentals of the CD-ROM Installation 

The following section describes the CD-ROM installation of the 
Solaris 9 OR 

Solaris 9 OE Installation and Upgrade Options 

There are a number of ways to install the Solaris 9 OE on your system, 
They include: 

• Solaris sun ins tall program 

• Solaris Web Start Installation software 

• Custom JumpStart™ procedure 

• Solaris Web Start Flash installation 

• Standard upgrade 

• Solaris Live Upgrade method 

This module focuses on the sunins tall program, 

Solaris Web Start 3.0 Installation Software 

The Solaris Web Start 3,0 Installation is a software application powered by 
Java™ technology, The Solaris Web Start program uses a graphical user 
interface (GUI). The GUI guides you through the installation of the 
Solaris 9 OE arid other software on a single system from either a local or 
remote CD-ROM drive. Boot the system from the Solaris 9 Installation 
CD-ROM to invoke the Solaris Web Start program. 



The Solaris Web Start program enables you to move easily forward and 
backward during the installation process to make changes as needed. 
Installation tasks are divided into panels that prompt you to enter system 
configuration information. The panels also offer you the opportunity to 
select default values. 

You must interact with Solaris Web Start throughout the installation or 
upgrade procedure, Consequently^ this method might not be the most 
efficient method when you need to install or upgrade several systems. 
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Custom JumpStart™ Installation 

The Solaris JumpStart procedure installs Solaris OE software on a system 
by referencing a user-dot tried profile "ion can CUSt0mi2e profiles for 
different types of systems. 

A JumpStart installation provides a hands-off installation across the 
network and is based on a central-configured server. The JumpStart 
procedure is a command-line interface that enables you to incorporate 
shell scripts. The shell scripts include pre-installation and post-installation 
tasks. You choose the profile and the scripts to use for installation or 
upgrade. Then the custom installation method installs or upgrades the 
system. 

Solaris Web Start Flash Installation Software 

The Solaris Web Start Flash installation software enables you to install 
many systems based on a configuration that you install on a master 
system. After you have installed and configured the master system, you 
create a flash archive from the master system, You create as many flash 
archives as you need and choose which flash archive to install on each 
system. 

The standard Solaris OE installation methods install each Solaris OE 
package individually. This method of package-based installation is time 
consuming because the installation must update the package map for each 
package. The Solaris Web Start Rash software's archive installs on your 
system much faster than when you install each of the individual Solaris 
OE packages/ because you are only producing a copy of an already 
installed system. 

Solaris upgrade options include both the standard upgrade and the live 
upgrade- 
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Standard Upgrade to the Solaris OE 



A standard upgrade merges the new version of the Solaris OE with the 
existing files on the system's disk. The methods available for a standard 
upgrade are Solaris suninstall program, the Solaris Web Start software, 
and the custom JumpStart procedure. 

A standard upgrade saves many of the modifications that were made to 
the OE with the previous version of the Solaris OE. Because the Solaris OE 
is unavailable to users during the standard upgrade, the standard 
upgrade results in longer periods of downtime. 



The Solaris Live Upgrade Software upgrades a duplicate boot 
environment while the active boot environment is still running. This 
method eliminates downtime of the production environment, The Solaris 
Live Upgrade method can be run with either a GUI or a command -line 
interface. First, create a duplicate boot environment. After that has been 
created, upgrade or install a Solaris Web Start Flash archive on the 
inactive boot environment. When you are ready, activate the inactive boot 
environment. During the next .reboot, the inactive boot environment 
becomes the active boot environment. If there is a failure, you can recover 
your original boot environment by reactivating it and rebooting the 
system. 

Solaris Live Upgrade Software requires enough available disk space to 
create a duplicate of your boot environment. To estimate the file system 
size needed to create a boot environment , start the creation of the new 
hoot environment. The file system size is calculated, and you can then 
abort the process. 



Hardware Requirements for Installation of the 
Solaris 9 OE 



A Solaris 9 OE installation requires: 

• A system based on an UltraSPARC® processor 

• 64 Mbytes of memory 

• 2.3 Gbytes of disk space 

• A keyboard and monitor 

• Access to a CD-ROM drive or an installation server 



Solaris Live Upgrade Software 
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Software Components of the Solaris OE 

The Solaris OE software is organized into three components: 

• Software packages 

• Software clusters 

• Software groups 

Figure 5-2 shows the relationship among the Common Desktop 
Environment (CDE) software components. 




Configuration for the 
Developer Software Group 

Figure 5-2 Solaris OE Software Components 
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Software Packages 

A software package contains a group of software files and directories. The 
package also contains the related software installation scripts. 



Software Clusters 



During the software installation process, software clusters group logical 
collections of software packages together, Table 5-1 shows the software 
packages that are grouped into the CDE software cluster. 

Table 5-1 Packages Included Ln the CDE Software Cluster 



SUWWdtab 


SUNWtathed 


SUNWdtmad 


sUNWeudhr 


SUNWdtbas 


SUNWdthev 


SUNWdtm$ 


StINWeudhs 


SUNWdtdem 


SUNWtiticn 


SUNWdtwn 


SUNWeudis 


SUNWdtdmn 


SUNWdtiin 


SUNWeudba 


SUNWeudlg 


SUMMtdat 


SUNWdt inc 


SUNWeudbd 


SUNWmfman 


SUNWdthe 


SUMWdtma 


SUNWeudda 





Some software clusters contain only one software package, 

Solaris OE Software Groups 



Software groups are collections of Solaris OE software packages. Each 
software group includes support for different functions and hardware 
drivers. The Solaris OE is made up of five software groups: 

m Core 

• End User System Support 

• Developer System Support 

• Entire Distribution 

« En ti re Dis tri b ution PI us Original Equi p m o n t M a n 1 1 1 L i c tn re rs ( O E M ) 
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Figure 5-3 shows the software groups that compose the Solaris OE. 




The Core software group contains the minimum software required to boot 
and run the Solans OE in a minimum configuration, without the support 
to run many server applications. The Core software group includes a 
minimum of networking software, including Telnet, File Transfer Protocol 
(FTP), Network File System (NFS), Network Information Service (NIS) 
clients/and Domain Name Service (DNS). This software group also 
includes the drivers required to run the Common Desktop Environment 
(CDE) but does not include the CDE software. The Core software group 
also does not include online manual pages. 

End User System Support Softwara Group (suwwcuser) 

The End User System Support software group contains the Core software 
group and also contains the recommended software for an end user plus 
the CDE. 
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Developer System Support Software Group (suNWCprog) 

The Developer System Support software group contains the End User 
System Support software group. It also contains the libraries, the include 
files, the online manual pages, and the programming tools for developing 
software. 



Entire Distribution Software Group (suNWCall) 

The Entire Distribution software group contains the Developer System 
Support software group. It also contains additional software needed for 
servers. The software that is in the Entire Distribution software group is 
the entire Solaris OE software release minus OEM support, 



Entire Distribution Plus OEM Support Software Group 

(SUNWCXall) 

The Entire Distribution Plus OEM Support software group contains the 
entire Solaris OE software release- It also contains additional hardware 
support for OEMs. This software group is recommended when you are 
installing the Solaris OE software on non-Sun servers that use 
Ultra SPARC processors. 



METACLUSTER=STJWWCal 1 
METACLUSTER=SUNWCprog 
METACLUSTER=SUNWCuser 
METACLUSTER=SUNWCreq 
METACLUSTER=SUNViOtireQ 



To view the names of the cluster configurations, perform the command; 

cli 



n grep METACLUSTKK / var / s adni/ sys t em / admin/ . clus t e rtoc 

METACLUSTER=SUM^Xal 1 




Note - The metacluster SUNWCmreq is a hidden metacluster. it allows you 
to create a minimal core metacluster by de-selecting packages from the 
core metacluster, 



To determine which cluster configuration has been installed on the 
svstem, perform the command: 

* cat /vair/sadm/sye tern /admin /CLUSTER 

CLUSTER-SUNWCXal 1 
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Installing the Solaris 9 OE From a CD-ROM 



In the Solaris 9 OE, the suninstail program uses Tab Window Manager 
(WM) for window management, 

TWM provides the following features: 

• Title bars 

• Shaped windows 

• Several forms of icon management 

• User-defined macro functions 

• A click-to-type and pointer-driven keyboard focus 

• User-specified key and pointer button bindings 



Consider the following general guidelines while planning an installation: 

• Allocate additional disk space for each language that you install. 

• Allocate additional space in the /var hie system if you plan to have 
your system support printing or mail, 

• Allocate double the amount of physical memory in the /var file 
system if you plan to use the crash dump feature savecore on your 
system. 

• Allocate additional space in the /export file system if you plan to 
provide a home directory file system for users on the Solaris 9 OE, 

• Allocate space for the Solaris software group you want to install. 

• Allocate an additional 30 percent more disk space for each file 
system that you create, and create a minimum number of file 
systems, This leaves room for upgrades to future software releases. 



Note - By default, the Solaris OE installation methods create only 
the / (root) file system and the swap partition, 



• Allocate additional disk space for additional software or third-party 
software. 



Pre-lnstallation Information 



■ 





Installing the Solaris™ 9 Operating Environment 

Copyrighi 2003 Sun Microsystems, Inc. AN Righis Ressrv&tl Sun Services, Revision A2 



5-9 



Installing the Solans 9 OE From a CD-ROM 



Before installing the Solaris OE software on a networked standalone 
system, you must prov ide the following information: 



Host name 



Host Internet 
Protocol (IP) address 



Name service type 



Subnet mask 



Determine a unique, and usually, short name for 
the networked system. You can use the 
command unarne -n to find the host name on 
an existing system. 

Determine the software address that represents 
the host address and network address. You can 
use the ifconfig interface command (for 
example, i f con fig hmeG) to display your 
current IP address. 

Determine if the networked system is to be 
included in one of the following types of name 
service domains: Lightweight Directory Access 
Protocol (LDAP), NIS, Network Information 
Service Plus (NIS+), DNS, or none. 

Determine if the networked system is included 
in a particular subnet. The subnet mask is 
stored in the /etc / ne tma s ks file . 



Note - A subnet is used to partition network traffic Segmenting network 
traffic over many different subnets increases the bandwidth available to 
each host. 



Geographic 
location and 
time zone 

root password 



Language 



Determine the specific region where me networked 
system physically resides. 

Determine a password assigned to the root user. Use 
the root password to gain access to root privileges 
on the networked system. 

Determine the language with which to install the 
Solaris OE. Use the CD-ROM labeled Solaris 9 
Installation SPARC* Platform Edition, The 
installation software enables the user to chcxteti fcftnfl 
a list of languages. Prompts, messages, and other 
installation information are displayed in the chosen 
language. The language choices include English, 
German, Spanish, French, Italian, Japanese, Korean, 
Swedish, Simplified Chinese, and Traditional 
Chinese, 
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As the last step in the p re-installation process, make sure the following 
Solaris 9 OE CD-ROM set is available: 

• Solaris 9 Installation English SPARC Platform Edition or Solaris 9 
Installation Multilingual SPARC Platform Edition 

• Solaris 9 Software 1 of 2 CD-ROM SPARC Platform Edition and 
Solaris 9 Software 2 of 2 CD-ROM SPARC Platform Edition 

• Solaris 9 Languages SPARC Platform Edition 

Before performing a software installation, always back up any 
modifications or data that exist m the previous version of the Solaris OE, 
and restore them after completing the installation. 



Demonstration: Performing an Interactive Installation 

In this demonstration, your instructor leads you through an interactive 
installation of the Solaris 9 OE. 

Preparation 

The interactive installation demonstration requires a networked, 
standalone system configured with a 2-Gbyte, or larger, boot disk. 
Depending on the speed of CD-ROM devices in use, the complete 
installation process requires approximately one hour, 

Demonstration Summary 

Boot the system from the Solaris 9 CD-ROM 1 of 2, and install the Solaris 
9 OE software. Create a configuration as follows: 

• Assign host name, IF address, subnet mask, routing, time zone, and 
naming service information compatible with the classroom 
configuration. 

• Perform an initial installation, and use the Entire Distribution 
configuration cluster. 

• Select the appropriate boot disk, and manually lay out your file 
system. 

• Create slices for the / (root), swap, /opt, /usr, and /export /home 
file systems, 

• Elect not to install additional software products. 

• Set the root password to cangetin. 
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•J§ 



# kit 0 



ok boot cdrom 



Demonstration Instructions 

Complete the following steps: 

1. Insert the Solaris 9 OE CD-ROM 1 of 2 into the CD-ROM drive. If the 
current version of the Solaris OE is running, log in as root, and 
bring the system to run level 0. 

You can also abort the Solaris OE by pressing the Stop-A key 
sequence, 

2. Boot the system from the CD- ROM. Ignore error messages, such as 
cable problem messages, that relate to network interfaces that are not 
attached. 

The installation program is loaded into random access memory 
(RAM), and the installation process begins automatically. However, 
no changes ajre made to the disk until you click the Begin Installation 
button at the end of the installation process, 

3. When the instaDation software is finished loading, a list of languages 
appears. Prompts, messages, and other installation information are 
displayed in the chosen language. English is the default language 
choice. You can select a different language from the list of available 
languages. 

Select a Language 



0 English 

1 French 

2 German 

3 Italian 

4 Japanese 

5 Korean 

6 Simplified Chinese 

7 Spanish 

8 Swedish 

9 Traditional Chinese 



Please make a choice (0-9), or press h or ? for help: 
Respond by making your language selection. 
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4. A list of locales appears, Respond by making your locale selection. 
Select a Locale 

58 U.S.A. (en_US.ISOS859-15) 

... < remaining lines removed > 

If the Solaris suninstall program detects a frame buffer for the 
system, it uses the GUI. If it does not detect a frame buffer, the 
suninstall program uses the command-line interface. The content 
and sequence of instructions in both are generally the same. This 
demonstration uses the GUI. 



Starting Window System 

The TWM starts up, and two windows appear, Figure 5-4 shows the 
first of these windows to appear. The Solaris Install Console window 
remains open throughout the installation .and provides information 
pertinent to the installation, 



The system responds with: 





The system zoning up, Please wait 
Begin system idervMf i cat ton. 



JUL 





fc 




Figure 5-4 Solaris Install Console Window 
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Figure 5-5 shows the second window that appears when the TWM 
starts. The Solaris Installation Program window provides a brief 
description of the installation process. 



The Solaris Installation Program 

The Solaris Installation program 1s divided Into a series of short sections 
where you'll be prompted to provide information for the installation At 
the end of each section, you'll be able to change the selections you've 
made before continuing. 

About navigation, . . 

- The mouse cannot be used 

- If your keyboard does not have function keys, or they do not 
respond, press ESC j the legend at the bottom of the screen 
will change to show the ESC keys to use for navigation, 



F2_Continue FcU-ielp 




Figure 5-5 Solaris Installation Program Window 



5. When you have read the brief description, press F2. 
Figure 5-b shows the next window that appears. 



Identify This System 

On the next screens, you must identify this system as networked or 
non-networked, and set the default time zone and date/time. 

If this system is networked, the software will try to find the information 
it needs to identify your system, you will be prompted to supply any 
information it cannot find. 

> To begin identifying this system, press F2. 



m 



F^ < ,Cont1 nue F6_Hel p 



Figure 5-6 Identify This System Window 
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Read the description of the identification process, When yon are 
finished, press F2. 

Figure 5-7 shows the next window that appears. 



Network Connectivity 

Specify Yes 1f the system 1s connected to the network by one of the Solans 
or vendor network /communication Ethernet cards that are supported on the 
Solaris CD See your hardware documentation for the current 11st of 
supported cards. 

Specify No if the system 1s connected to a network/communication card that 
ie, not supported on the solans CD, and follow the Instructions listed under 
Hel p . 



Networked 



[ ] 



^.continue P6_Heip 




Figure 5-7 Network Connectivity Window 







Select Yes if your svstem is connected to a network. Use the arrow 
keys to move between choices, and press Re rum to select the choice. 
Use these steps to make selections for the remainder of the 
demonstration* When you have made your selection, press F2. 
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Figure 5-8 shows the next window that appears. 



tft sysuuool 



DHCP 



Or* this screen you must specify whether or not this system should use DHCP 
for network interface configuration. Choose Yes if DHCP is to be used, or 
No 1f the Interfaces are to be configured manually. 

NOTE: DHCP support will not be enabled \ 1f selected, until after the system 
reboots . 

Use DHCP 

LJL ¥es 
EEf] No 



F2 .Continue F6_He|p_ 

Figure 5-8 DHCP Choice Window 




8, Select No to confirm that the system is not using Dynamic Host 
t 'on figuration Protocol (DHCP) lor network interface information. 
To continue, press F2. 



v J -J 
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9. If your system has more than one network interface, Figure 5-9 
appears. 



primary Network interface 

On this screen you must specify which of the following network adapters 1s 
the system's primary network interface, usually the correct choice is the 
lowest number However, do not guess; ask your system administrator 1f 
you' re not sure. 

> To make a selection, use the arrow keys to highlight the option and 
press Return to mark 1t [X] ; 



Primary network interface 

(Efi hrneO 
C ] hmel 




F 2_C on 1 1 nue F 6_He \p 



Figure 5-9 Primary Network Interface Window 

I to! l lBf V V 

Select which network interface you want to make your primary 
interface (in this example, choose hmeO). Press F2 to continue. 

Figure 5-10 shows the next window that appears. 



Host Name 



On this screen you must enter your host name, which Identifies this system 
on the network, The name must be unique within your domain; creating a 
duplicate host name will cause problems on the network after you Install 
Solaris. 

A host name must be at least two characters; 1t can contain letters, digits, 
and minus signs {-0 * 



Host name: 



F2_Cont1nue F6_He1 p 

Figure 5-10 Host Name Window 
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10 + Enter the assigned host name for the system in the Host name field. 
To continue, press F2. 

Figure 5-11 shows the next window that appears. 



IP Address 

On this screen you must enter the Internet Protocol CIP) address for this 
system. It must be unique and follow your site's address conventions , or a 
system/network failure could result. 

IP addresses contain four sets of numbers separated by periods ffor example 
129,200,5 I). 

IP address: 




F 2 _Conti nue F6_Hel p 



Figure 5-11 IP Address Window 

11. Enter the assigned IP address in Oie IP address field. To continue, 
press F2. 

Figure 5-12 shows the next window that appears. 



Subnets 

On this screen you must specify whether this system 1s part of a subnet, If 
you specify incorrectly, the system will have problems communicating on the 
network after you reboot. 

> To make a selection, use the arrow keys to highlight the option and 
press Return to mark it [X] . 

System part of a subnet 
(EH Yes 

L ] NO 



F2 ..Continue FoJHeU' 

Figure 5-12 Subnets Window 
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12, Select Yes to confirm that the system is part of a subnet. To continue, 
press F2. 

Figure 5-13 shows the next window feat appears. 



ivetroask 

On this screen you must specify the net mask of your subnet, A default 
netmask 1s shown j do not accept the default unless you are sure 1t is 
correct for your subnet. A net mask must contain four s*j- -r r.\ ml •- 
separated by periods (for example 255.255,255.0). 

New, H**M*ME I 



F2_Cont1nue PS_Hel p 




Figure 5-13 Netmask Window 

• ■ - 

13. For this demonstration^ accept the default subnet mask of 
255,255.255 . 0. To continue, press F2. 

Figure 54 4 shows the next window that appears. 



IPv6 

On thts screen you should specify whether or not IPv6, the next generation 
Internet Protocol, will be enabled on this machine, Enabling IPv& will have 
no effect If this machine is not on a network that provides IPv6 service. 
IPv4 service will not be affected if IPv6 is enabled. 

> To make a selection, use the arrow keys to highlight the option and 
press Return to mark it [X] . 



Enable IPv6 

ves 
no 



F2_continue FS.Help 

Figure 5-14 IPv6 Window 
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14, Confirm that the system does not use Internet Protocol version 6. To 
continue, press F2, 

Figure 5-15 shows the next window that appears . In this window, 
you can let the operating environment try to find a default route, or 
you can specify one, 



Default Route 

On this screen you must specify how to set the default route. You can let 
the software try to find one or you can specify one , 

> To make a selection, use the arrow keys to highlight your choice and press 
Return to mark it [X] . 



Default Route 




[ ] Find on> 
HIE Specify 



one 



F2_Cont1 nue F6_Hel p 




Figure 5-15 Default Route Window 



15. Select Specify one. To continue, press F2. 
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Figure 5-16 shows the next window that appears. 





Default Rot it IP Address 






On this screen you must enter the IP address of the default 
entry will be placed in the /etc /defaul t router file and will 
route after you reboot (example 129 14&.89 225). 


route . 
be the 


This 
def aul t 


Router ip Address: ^^^^^^^^M 






F2_Continut FS_Help 







Figure 5-16 Default Route TP Address Window 



16, Enter the default route IP address provided to you by your 
instructor. To continue, press F2. 

Figure 5-17 shows the next window that appears. 









Confirm information 






> Confirm the following Information. If 1t is correct, 


press F2j 


to change any Information, press F4 . 




Networked 


ves 




Use DHCP 


No 




Host name 


sys4i 




IP address 


192 . 1 68, 30 41 




System part of a subnet 


Yes 




Netmask 


255,255.255,0 




Enable IPv6 


NO 




Default Route 


specify one 




Router IP Address 


192. 168.30 ) 




F2_Cont1nue F4_Change FGJHelp 





Figure 5-17 Confirm System Identification Window 
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17. Verify your system configuration, Press F4 to go back arid make 
changes or to correct errors. To continue, press F2. 

Figure 5-18 shows the next window that appears. 



configure Security Policy; 
Specify Yes if the system will use the Kerberos security mechanism, 
Specify No if this system will use standard UNIX security. 
Confl 9ure kerberos security 

yVes 
No 



FC.Continue P6_Help 



Figure 5-18 Configure Security Policy Window 

IS. Select No to configure the Solaris 9 OE to use standard UNIX® 
security. To continue, press F2. 

Figure 5-19 shows the next window that appears, 

Confl rm Information: 

• Confirm the following information If it is correct, press F2; 
to change any information, press F4. 

Configure Kerberos Security: No 



P2_Continue E4_Change P6_He lp 

Figure 5-19 Confirm Security in formation Window 
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19, Press F2 to confirm the No response and to display the next window. 
Figure 5-20 shows the next w indow that appears. 



Name 



On this screen you must provide name service information. Select the name 
service that will be used by this system, or None 1f your system will either 
not use a name service at ail, or if it will use a name service not listed 
here. 

i To make a selection, use the arrow keys to highlight the option 
and press Return to mark 1t [X] 



Name service 



t 1 NIS+ 
[ J NIS 
DNS 
I DAP 
None 



C ] 




F2_Contlnue 



FQHelp 



Figure 5-20 Name Service Window 



20, Seiect None as your name service. To continue, press F2. 
Figure 5-21 shows the next window that appears. 



C on f i rm in f o r ma t i on 



> Confirm the following information, if 1t is correct, press F2; 
to change any information, press F4 



Maine service; None 



F2_X ont inue F4_Change F6_He 1p 

Figure 5-21 Confirm Name Service Information Window 
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21. To change the information, press F4, To continue, press F2. 
Figure 5-22 shows the next window that appears. 



Time Zone 

On this screen you must specify your default time zone. You can specify a 
time zone 1n three ways, select one of the continents or oceans from the 
list, select other - offset from GMT, or other - specify time zone file, 

3 To make a selection, use the arrow keys to highlight the option and 
press Return to mark it [X] , 



Continents and Oceans 

H Africa 
1 Americas 
3 Antarctica 
3 Arctic Ocean 
] Asia 

] Atlantic ocean 
] Australia 
3 Europe 
3 Indian ocean 



F2_Continue 



F6_H6lp 




Figure 5-22 Time Zone Window 



22. Select the appropriate time zone continent. To continue, press F2. 
Figure 5-23 shows the next window that appears. 





Country 


or Region 




:■ To make a selection., use 


the arrow Keys to highlight the option and 


press 


Return to mark 1t 




Countries and Regions 






Umted States ' 




: J 


Anguil i a 




i 3 


Antigua & Barbuda 




[ ] 


Argentina 




[ ] 


Aruba 




C 3 


Bahamas 




t 3 


Barbados 




[ 3 


Bel ize 




C 3 


Bolivia 




E 3 


Bran 1 




L 1 


Canada 




[ 1 


Lj-vmar I :. 1 and : 




v [ ] 


Chile 




F2 jQcrnt-tnue P 6_Hel p 





Figure 5-23 Country or Region Window 
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23, Select the appropriate time zone country or region. To continue, 
press F2. 

Figure 5-24 shows the next window that appears, 



Time Zone 



To make a selection, use the arrow keys to highlight The option and 
press Return to mark 1t [KJ . 



Time zones 



Eastern Time 

Eastern Time - Michigan - most locations 
Eastern Time - Kentucky - Louisville area 
Eastern Time - Kentucky - Wayne County 
Eastern Standard Time - Ipidiana - most locations- 
Eastern Standard Time - Indiana - Crawford County 
Eastern Standard Time - Indiana - Starke county 
Eastern Standard Time - Indiana - Switzerland County 
] Central Time 

] Central Time - Michigan - Wisconsin border 
3 Central Time - North Dakota - Oliver County 
K] Mountain Time 

] Mountain Time - south Idaho & east Oregon 
F2_Lontmue Ff^Helo 



Ficure 5-24 Time Zone Window 

24. Select the appropriate time zone for your area. To continue, press F2. 
Figure 5-25 shows the next window that appears. 



1 



Date an- Mm* 



Accept tn« default date and time or enter 
new va u$i< 



Date dnc time: 09:58 



Year 


i.4 diqltS) 




Month 


h - 1 : "> 


: 03 




u-so 


: 20 


Hour 




. 09 


Minute 


CO- 55! 


: 5S 



F2_C on t1nue F$_Hel p 

Figure 5-25 Pate and Time Window 
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25* Accept the default date and time, or enter neiv values, To continue, 
press F2* 

Figure 5-26 shows the next window that appears. 



Confirm Information 

> Confirm the following Information. If 1t is correct, press f?j 
to change any information, press F4* 



Time zone: Mountain Time 
(US /Mountain) 
Date and time: 2002-03-20 09:53:00 AM 



F2_Cont1nue 



.■ • 

■ ■ 

F4_Ch ang e F6_ HeTp 




Figure 5-26 Confirm Date and Time Information Window 

26. Review the information. To change the information, press F4. To 
continue, press F2. 

Figure 5-27 shows the next window that appears. The console 
window displays additional information while generating a software 
table of contents, checking the rules . ok file, and executing scripts, 



Stfaris mm uwisvte 383$ 



The system 1s coming up. FT ease wait, 
Begin system Identification . 
System 1 dent if i cat 1 on compl ete . 

Generating software table of contents Cthis may take a few minutes. , J 

Table of contents complete 

Starting Solaris installation program 

Executing Jumps tart pre install phase . , . 

Searching for sol Start directory.,. 

Checking rules. ok file.,. 

Using begin script- instal l_begin 

Using finish script: patch_f1ni$h 

Executing SolStart ^reinstall phase,,, 

Executing begin script " install _beg1n" . 

Begin script 1ns tal l_beqin execution completed, 

# i 



Figure 5-27 Solaris Install Console Window 
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Figure 5-28 shows the next window that appears. 



Solaris Interactive Installation 

This system is upgradable, so there are two ways to install the Solaris 
software , 

The upgrade option updates the Solaris software to the new release, saving 
as many modifications to the previous version of Solaris software as 
possible. Back up the system before using the Upgrade option 

The Initial option overwrites the system disks with the new version of 
Solaris software. This option allows you to preserve any existing file 
systems. Bad. uc any modifications made to the previous version of Solaris 
software before starting the Initial option, 

After you select an option and complete the tasks that- follow, a summary of 
your actions will be displayed. If you want to install the system with a 
Flash archive , select Initial 




FZ upgrad e E4^in1t1al Fsj&flx F6_neTp 

Figure 5-28 Solaris Interactive Installation Window 



If you have previously installed a version of the Solaris OE software 
on the system, the suninstall program advises you that the system 
can be upgraded. The upgrade procedure attempts to preserve local 
modifications to the system whenever possible- An upgrade 
procedure generally takes two or three times longer than the initial 
installation procedure because it does file comparisons. 

Press F2 to bypass the initial procedure and to access the upgrade 
program. The first tiling the upgrade program does is analyze the 
current Solaris OE files and disk configuration. The upgrade 
program then calculates the size of replacement packages to 
determine if the disk partitioning is adequate for the new software. If 
adequate space is allocated, the program prompts you to customize 
the software for the upgrade. 

The upgrade program attempts to mount all file systems listed in the 
/etc/vf stab file. If any file system cannot be mounted, the upgrade 
program reports the failure and then exits. 
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If there is no need to preserve existing data on the system, you press 
F4 to perform the initial installation. The Initial option destroys the 
existing file systems as it performs an installation of the Solaris 9 OE. 

27. For this demonstration, use the Initial installation method. Press F4 
to select the Initial installation method. 

Figure 5-29 shows the next window that appears. 



Solaris Interactive Installation 

you n be using the initial option for installing Solaris software on the 
system. The initial Option overwrites the system disks when the new Solaris 
software 1s Installed. 

On the following screens, you can accept the defaults or you can customise 
how Solaris software will be installed by: 

- selecting the type of Solaris software to install 

- Selecting disks to hold software you ve selected 

- Specifying how file systems are laid Out on th«S disks- 

T.r? r completing these tasks, a summary of your selections '.called * 
profile) will be displayed. 

There are two ways to install your Solaris software 

- "Standard" Installs your system from a standard sol ■iris Distribution 

- "Flash" installs your system from one: or more Flash Archives 




P2_Standard F j_Co B a ck F4_Flash F5_E>;1t FS_Help 

Figure 5-29 Solaris Interactive installation Window - Initial Option 

The Standard method and the Flash method are the two methods 
available for installing the Solaris 9 OE. 

28. Select the Standard method for this demonstration. To continue, 
press F2. 
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Figure 5-30 shows the next window that appears. 




Solaris Interactive Installation 

You'll be using the Initial option for installing Solaris software on the 
system. The initial option overwrites the system disks when the new Solaris 
software is installed. 

on the following screens, you can accept the defaults or you can customize 
how Solaris software will be installed by 

- Selecting the type of Solaris software to insxall 

- Selecting disfcs to hold software you've selected 

- Specifying how file systems are laid out on the disks 

After completing These tasks, a summary of your selections (called a 
profile) will be displayed. 

There are two ways to Install your Solaris software; 

- "Standard" Installs your system from a standard Solaris Distribution. 

- "Flash" installs your system from one or more Flash Archives. 



F2_S tandard F3_GO Back F^Fl ash F S ^&rtl F 6_He1p 

Figure 5-30 Solaris Interactive Installation Window - Loading 
installation Media 

The Solaris Interactive Installation Loading Install Media window 
appears briefly to inform you that the suninstall program is 
loading the software. 
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Figure 5-31 shows the next window that appears. 



Select C« 



ect the geographic regions for which support should be installed, 

] Central America 

3 Australasia 

] south America 

] Northern Africa 

] widdle East 

] Eastern Europe 

] Northern Europe 

] Western Europe 

] Central Europe 

] Southern Europe 

•■•] No'-tn America 

] Asia 



Move left, right x u 




FZ_Cont-nue 



P3,Go Back F5,Exit P6 _Help 



Figure 5-31 Select Geographic Regions Window 



29. 



Geographic regions are composed of locales and languages. You can 
select support for a portion of a region or an entire region. You can 
also select support for more than one region. An X means support 
for a region or locale is selected. A slash (/} means the region or 
locale is partially selected. 

Make the appropriate selections. To continue, press F2. 
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Figure 5-32 shows the next window that appears. 



|¥f suiitoslafl 



Select 64 Bit 



HZ 



Select 64-bit if you want to install the Solaris 64-b1t packages on this 
system. 



Select To Include Solaris 64-bit Support 



■ 



■ : 



F2_Continue F3_Go Back F5^E*1t 



Figure 5-32 Select 64 Bit Window 

MjpBB BI raf IBB HE ilL W f ^ 

30. If your system is capable of supporting 64-bit applications, select the 
available option, To continue, press F2- 



Installing the Solaris™ 9 Operating Environment 

Cocyrighl 2003 Sun Microsystems, inc. AH Rights Reserved, Sun Services, Revision A,2 



5-31 



Installing the Solaris 9 OE Fro m a CD-ROM 



Figure 5-33 shows the next window that appears. 

nasi ; : zz— -^_i===rzL'--zz.-:.'- . ::: . : ::zm 

Select Software 

Select the Solaris software to install on the system 

NOTE; After selecting a software group, you can add or remove software by 
customizing It, However, this requires understanding of software 
dependencies and how Solaris software Is packaged, The software groups 
displaying 64-bit contain 64-b1t support 



y Entire Distribution plus OEM support 54-bit 1914.00 M£ 

Entire Distribution 64-bit 1 37S 00 ME 

[ ] Developer System Support 64-tnt 16^.00 Me 

[ ] End User System Support 64-bit I 2 42 . 00 ME 

[ ] Core System Support 64-bit 677.00 MB 




■ ■ ■ ■ ■ ■ ■ ■ 




F : _<: o ntlnue F3_ Go Bach ^customize RS^gxtt F6_Help 

Figure 5-33 Select Software 

Yon can select the software group that most closely fits the specific 
needs of your system, Notice the recommended or estimated disk file 
size required to install each of the software groups* These sizes vary 
based on the svstern type and kernel architecture. 

3L Select the Entire Distribution 64-bit, To continue, press F2. 
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Figure 5-34 shows the next window that appears. 



Select Disks 



On this screen you must select the disks for installing Solaris software 
Start by looking at the Suggested Minimum field; this value Is the 
approximate space needed to instill the software you've selected Keep 
selecting disks until the Total Selected value exceeds the Suggested Minimum 
val ue . 



Disk Device CSlze) 



Available Space 



HE cotodo 
[ ] citodo 



(3222 MB) boot disk 
(1304 ME) 

Total Sel ected i 
Suggested Minimum: 



MB CF4 to edit) 
1 30* MB 




^conti nu e F3,Go Back F4^n ' : ' F5jE*n; F6_Help 



Figure 5-34 Select Disks Window 



32. Select the disk or disks on which you are installing the software. 

The window displays values that reflect available space on the disk 
and the suggested minimum space. Recall that the size of the clusters 
varies and that there are other general considerations for 
determining disk slices and sizes* If you choose to change your boot 
drive, the suninstall program prompts you to verify the change 
and makes changes to your nonvolatile random access memory 
(NVRAM) parameters. 

33. To continue, press F2< 
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Figure 5-35 shows the next window that appears. 



Preserve Data? 



31 



Do you want to preserve existing data? At least one of the disks you ve 
selected for Install 1ng Solaris software has file systems or unnamed slices 
that you may want to save. 




FZ_Contm ue F3_Co Back F4_Fre$ er ve F5,Exit F6_Helc 
Figure 5-35 Preserve Data Window 

The initial installation preserves data only on demand. 
34, To continue, press F2. 



Note - If you select F4 to preserve data, the suninstall program 
displays a window that enables you to preserve data on a specific 
partition of the disk, If your system was previously a home director}' 
server, you might want to preserve the /export/ home file system* 
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Figure 5-36 shows the next window that appears, 




MUtomati :al 1 y Layout File £ .■■item:"' 

Do you want to use auto-layout to automatically layout file systems? 
Manually laying out file systems requires advanced system administration 



F2_Auto Lay out F3„Go Sack jF4^War>ual Layout FS_Exit FSjnelp 
Figure 5-36 Automatic Layout File System Window 

The suninstall program can automatically lay out the file system 
arrangement, or you can select disks and slices manually. 

35, Press F4 to select Manual Layout. 



skills. 
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Figure 5-37 shows the next window that appears. 



File System 



The summary below 1s your current file system and disk layout, based on the 
information you've supplied, 

NOTE: If you choose to customize, you should understand file systems, their 
intended purpose on the disk, and how changing them may affect the operation 
of the system. 



File system/Mount point 



Disk/slice 



Size 




F^_contmue 



F3_Go Back 



F4_CUS$om1ze 



F5_E?ot 



F&_H6lp 



Figure 5-37 File System and Disk Layout Window 

This window summarizes the current file system and disk layout. 
The window generally reflects the overlap partition of the boot drive, 

36. Press F4 to select Customize. 
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Figure 5-38 shows the next window that appears. 











list 


Customise Disk: cOtOdO 
Boot Device: cOtodOsO 










Entry s 


Recommended: 


ME 


Minimum: 





Slice M ount Point 



overlap 



Size CMS) 
0 
0 

8222 
0 
0 
0 
0 
0 



Capacity 
Al 1 ocated 
Free 




t J .Options 



PS^Cancil 



Figure S-38 Customize Disk Window 



The Customize Disk window is a tool you use to reconfigure disk 
parti tions for each disk selected, There are numerous ways to 
partition slices and to name file systems. Your instructor should 
inform you of the number of partitions and their sizes for this 
demonstration. 

37. Select the disk slice you want to change, Enter the mount point for 
the file system that will reside on the slice and the size you want to 
apply to the slice. Press Return, 

The Size (MB) column reflects your changes. The Allocated and 
Free Space variables change as you configure each slice of the disk. 
Recommendations and minimum size requirements are displayed at 
the upper right. 

38, When you have finished reconfiguring the disk, press F4. 
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Figure 5-39 shows the next window that appears. 



\E sunlttstali 



01 sK Editing Options 

Show size in; 
[EH MBytes 
t J Cylinders 

Other Options: 

[ ] Show cylinder boundaries 

[ ] Load existing slices from VTOC label 




The Disk Editing Options window enables you to choose how disks 
are displayed and computed. 

39. Make your selections. To continue, press F2. 
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Figure 5-40 shows the next window that appears. 




Customize Disk: cOtOdO 
Boot Device; "OtOdOsC 



Entry: / 



Recommended r 



&3 MB 



Kim mum: 



79 MB 



Slice Mount Poin 



Size CMB> 



0 G 



150 
500 

z::: 

300 



1 swap 

2 overlap 
I /var 



4 



0 



5 /opt 

6 /usr 

? /export /home 



500 
1500 

5271 



Capacity: 
Allocated: 
Rounding Error: 
Free: 




3222 MS 

3221 WB 

1 MB 

0 m 



F2_0K E 4_0ptions F5_Cancel F6_ He\p 

Figure 5-40 Customize Disk Finished Window 

The Customize Disk Finished window enables you to review and 
modify your changes, 

40, To continue, press F2. 
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Figure 5-41 shows the next window that appears 



File System and Disk Layout 

The summary below is your current file systeui and disk layout, based on the 
information you've supplied- 

NOTE: If you choose to custom^*, you should understand file systems, their 
intended purpose on the disk., and how changing them may affect the operation 
of the system 



Pile system/Mount point 



swap 

overlap 

/var 

/opt 

/usr 

.' t -.!v>t":/hom£ 



Disk/Si 1ce 



cOtOdOsl 
cotodosz 

cOtOdOsS 
cotodoss 
cOtGdGs* 
C0t0d0s7 



Size 



500 ME 
2222 MB 
300 MB 
500 MB 
1500 MB 
527 1 MB 




F2_Continue F3_Go Back F4_CustOm i z-? -r E ■ : 



F6_Hel p 



Figure 5-41 File System and Disk Layout Window - Summary 



The File System and Disk Layout Summary window is your final 
confirmation of what the disk layout looks like, 

4L To continue, press F2. 
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Figure 5-42 shows the next window that appears. 




Mount Remote File Systems? 

Do you want to mourn software from a. remote file server? This may be 
necessary if you had to remove software because of disk space problems. 



P2_Continue f 3_ Go Back __ F4_geinote Mounts Pf._E>^1jt: Hf._He1p 

Figure 5-42 Mount Remote File Systems Window 

42. Press F4 to open a window that prompts you to enter a server name, 
an IP address, and a mount point to a location where you have 
stored data. To continue, press F2. 
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Figure 5-43 shows the next window that appears. 



7"S 



Profile 

The Information shown below is your profile for Installing Solaris software 
It reflects the choices you've made on previous screens. 



Install at inn Option Initial 
Boot Device: cotodo 
Client Services. None 



Locales; U.S,A CenjJS. I SG885$-1 ) 
Software Solaris 9, Entire Distribution 64-bit 



File System and Disk Layout 




F ^Continue F4_Change F5_E*it: f6_Help 



Figure 5-43 Profile Window 

The Profile window displays the installation choices you made in 
pre vious windows. 

This is the last window that enables you to change the options you 
have selected. 

43. W r hen yoti are satisfied with yoiur selections, press F2. 
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Figure 5-44 shows the next window that appears. 




mi 



Reboot After Installation? 

After Solaris software 1s Installed, the system must be rebooted, Vou can 
choose to have the system automatically reboot, or you can choose to 
manually reboot the system If you want to run scripts or do other 
custom izati on s before the reboot You can manually reboot a system by using 
the reboot(iM) command. 



£2_Beg1n i nstallation F5_Cance1 • 

Figure 5*44 Reboot After Installation Window 

The Reboot After Installation window enables you to choose 
between an auto or a manual reboot. 

44. After making your selection, press F2 to begin the installation 
process- 

The system begins the installation by writing a Volume Table of 



Contents (VTOC) on the disk or disks selected and creating file 
systems. 

Preparing system for Solaris install 

Configuring disk (cOtOdO) 

- Creating Solaris disk label (VTOC) 

Creating and checking ufs file systems 

- Creating / (cOtOdOsO) 

Beginning Solaris Installation 



ED Auto Reboot 
I ] Manual Reboot 
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Figure 5-45 shows the next window that appears. 



-m 



Solaris Initial Install 



MBytes Installed: 
MBytes Remaining; 



0,35 
682. OS 



Installing: Core Solaris, (Usr) 



l 



I 

40 



Figure 5-45 Solaris Initial Install Window 

The Solaris Initial Install window displays the software cluster 
currently being installed. The window indicates how many 
megabytes of the cluster have been installed and how many 
megabytes of the cluster remain to be installed. 

At the end of the installation of the Solaris 9 CD-ROM 1 of 2, the 
system reboots and displays guidelines for creating a root 
password: 

On this screen you can create a root password. 

A root password can contain any number of characters, but only the first 
eight characters in the password are significant, (For example, if you 
enter *alb2c3d4e5f6 1 as your root password, then l alb2c3d4' could also 
be used to gain root access , } 

You will be prompted to type the root password twice; for security, the 
password will not be displayed on the screen as you type it. 
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> If you do not wane a root password, press RETURN twice. 

Root password: 

Press Return to continue. 

45- Use cangetin as the root password on the newly installed system. 

If your hardware supports it, the system displays a message that 
asks you if you want to select the automatic power-saving feature. 

System identification is completed. 

*#*****++****************+++++*******^ 

This system is configured to conserve energy. 

After 30 minutes of idle time on this system, your system state 
will automatically be saved to disk, and the system will power-off* 

Later, when you want to use the system again, and you turn the power 
back on, your system will be restored to its previous state, 
including all the programs that you were running. 

Do you want this autamrtatic power -saving shutdown? 

(If this system is used as a server, answer n) [y,n, ?] n 

46. Type n to disable automatic power saving. 

The system responds with the following message: 
Autoshutdown has been disabled. 

'];!!?, if ] : if - -^^^j/\N 

Do you want the system to ask you about this again, when you next reboot? 
(This gives you the chance to try it before deciding whether to keep it* J 
[y,n, ?] n ■■■m 

47. Type n to confirm permanent disabling of the automatic power* 
saving shutdown feature. 

The system responds with the following message: 
The system will not ask you again about automatic shutdown. 

The "Using Power Management w AnswerBook describes more about how 
to change and set workstation energy-saving features. 

During the next phase of the installation, the CDE starts, and the 
remainder of the windows are displayed. 
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Figure 5-46 shows the next window that appears, 



H 1 - '.-ji 








Plea$« specify the media from which vou*Hi weiaH Sol arts 3 Software 2 or 
i {SPARC Pisiform Edition) 

mm 

! r#co 

! /Network F >te Svssem 








1 SOLARIS 


To sWp- installation of Solaris 9 Software 2 oi 2 (SPjAjR^Pbtform Edition), 
click Stop 


Next* j Slfip j 



Figure 5-46 Specify Media Window 



48. Select the CD option. To continue, click Next. 
Figure 5-47 shows the next window that appears. 





- 


J' . ..: .. 






I Insert CO 


Pleat* insert ihe r -D foi Solan* 3 Solvate 2 of 2(SP*flC Platform 

"; : -: : £dibon), 

: Wlai vou insert ft* CO, click OK 


j >4 


SOLARIS' 








*Batk | OK 



Figure 5-47 Insert CD Window 

49. Insert the Solaris 9 OE CD-ROM 2 of 2, To continue, click OK, 
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Figure 5-48 shows the next window that appears. 




Launching installer.,. 



uuw hing ir^iaiier foi solans % software 2 of 2 (SPARC Platform Edition) 
Please Watt. 




Figure 5-43 Launching Installer Window 



The Launching Installer window displays for a moment. 
Figure 5-49 shows the next window that appears. 



£xtr acting... 




Extract ftfu 



Figure 5-49 Extracting Window 
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The Extracting window displays a message whi te the CD-ROM is 
read. 

Figure 5-50 shows the next window that appears. 




Solaris 



Solaris 



Installing §q\bf,% 3 packages #*r1 2\ 




Figure 5-50 Installing Window 



While the system installs the packages from the second CD-ROM, 
the slide bar displays the progress of ike installation. 

* 
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Figure 5-51 shows die next window that appears, 




Figure 5-51 Installation Summary Window 

: ■ I jk Wm gy^ 

50, Qick Details to display the log file of the installation. The log file 
con ta i n s in forma tion about the packages installed. 

51. Click Next when you are finished reviewing the log file- 
Figure >52 shows the next window that appears. 

. ' VV "V ;: ' "' """"" i'Vi "■: 

.-^■ r v.,;- s ; V ^ -^V., ... >, : ^^^^J^A^. 




Reboot Now j 



Figure 5-52 Reboot Window 
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52. Click Reboot Now to reboot the system. 

53, After the system completes the reboot process, log in and verify that 
the system is operational. You can review additional log file 
information after the system has rebooted by looking at the 

/ var /sadm/ ins tal l_data/ instal l_log file. 

You have now completed the installation demonstration. 
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Performing Solaris 9 OE Package 
Administration 



Objectives 

Upon completion of this module, you should be able to: 

• Describe the fundamentals of package administration 

• Administer packages using the command-line interface 

The following course map shows how this module fits into the current 
instructional goal. 



Installing Software 



Installing the 




Performing 
Solaris 9 OE 




Managing 
Software 


Solaris™ 9 
OE 




Package 
Administration 




Patches on 
the Solaris 9 
OE 


. , ^ 











Figure 6-1 Course Map 
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Introducing the Fundamentals of Package Administration 



Software package administration adds software to systems and removes 
software from systems. Sim and its third-party vendors deliver software 
products to users in software packages. 



The term package refers to the method of distributing software products 
and installing them in systems, in its simplest form, a package is a 
collection of files and directories, 



Software packages contain: 

• Files that describe the package and the amount of disk space 
required for installation 

• Compressed software files to be installed on the system 

• Optional scripts that run when the package is added or removed 

The /var/sadm/ ins tall /contents File 

The /var/sadm/ ins tall /contents fUe is a complete record of all the 
software packages installed on the local system disk. It references every 
file and directory belonging to every software package and shows the 
configuration of each product installed. To list the contents of the 
/var/sadm/ ins tall /contents file f perform the command; 



# more /var/sadm/ install /contents 

(output edited for brevity) 

/fain= i /usr/bin s none SUNWcsr 

/dev d none 0755 root sys SUNWcsr SUNWcsd 

/ dev / al lkmem= . . / devi c es / p s eudo /mm@ 0 : a 1 1 kmem s none SUNWcsd 
/ dev/ arp= /devices /pseudo/arp@G :arp s none SUNWcsd 

/etc/ftpd/ftpusers e ftpusers 0644 root sys 185 15198 1008137961 SUNWftpr 
/etc/passwd e passwd 0644 root sys 467 38912 1008137367 SUNWcsr 



Software Packages 




Note - The Solaris OE software installation process installs all the 
required software packages automatically, based on the software group 
con figuration c h oic e . 
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The pkgadd command updates the /var/sadm/ ins tall /con tents file 
each time new packages are installed. 

The pkgrm command uses the /var/sadm/ ins tall /con tents file to 
determine where the files for a software package are located on the 
system. When a package is removed from the system, the pkgrm 
command updates the /var/sadm/ install /contents file. 

To determine if a particular file was installed on the system disk and to 
find the directory in which it is located, use the grep command to query 
the /var/sadm/ install /contents file. For example, to verify that the 
showrev command is installed on the system disk, perform the command: 



# grep showrev /var/sadm/ ins tall /contents 

/usr /bin/ showrev f none 0755 root sys 29040 1417 993448469 SUNWadmc 
/us r/ share /man/ smanlm / showr ev. lm f none 0444 root bin 6416 64169 
993108127 SUNWman 
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Administering Packages From the Command Line 

From the command line, you can add, remove, check the state of, and 
display information about packages, 

The command-line tools for viewing software, adding software, and 
removing software from a workstation after the Solaris OE software is 
installed on a system include: 

pkgadd Installs software packages to the system 

pkgrm Removes a package from the system 

pkginf o Displays software package information 

pkgchk Checks package installation state 



Note - Students need to insert the Solaris 9 Software 1 of 2 CD-ROM to 
aI^C demonstrate the steps described in this module, 



Displaying Information About Installed Software 
Packages 

Use the pkginfo command to display information about the software 
packages installed on the local system's disk, The /var/sadm/pkg 
directory maintains a record of all installed packages. 
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For example, to display information about software packages installed on 
the local system's disk, perform the command: 



# pkginfo | 


more 




<some output omitted> 




application NSCPcom 


Netscape Communicator 


system 


SUNWaccr 


System Accounting, (Root) 


system 


SUNWaccu 


System Accounting, (Usr) 


system 


STJNWadmap 


System administration applications 


sys tern 


SUNWadmc 


System administration core libraries 


system 


SUNWaudd 


Audio Drivers) 


ALE 


SUNWciuB 


Simplified Chinese iconv modules for 


system 


SUNWcsd 


Core Solaris Devices 


CTL 


SUNWctplx 


Portable layout services for CTL (64 


system 


SUNWdoc 


Documentation Tools 


application SUNWdej2p 


Java Plug- in 

: 



The column on the left displays the package category, such as application, 
system, Complex Text Layout (CTL), or Alternate Language Environment 
{ ALE). A CTL language is any language which stores text differently than 
it is displayed* An ALE is an alternate language, different from the basic 
Solaris OE languages. 

The center column displays the software package name. If it begins with 
SUNH it is a Sun Microsystems product. Otherwise, it represents a third- 
party package. 

The column on the right displays a brief description of the software 
product. 



Displaying information for All Packages 



To display all the available information about the software packages, use 
the pkginfo command with the - 1 option. 

For example, to view additional information about each software package 
installed on the local systems hard drive, perform the command: 

% pkginfo -1 | more 

(output omitted) 
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Displaying Information for a Specific Package 

To display the information for a specific software package, specify its 
name on the command line. 

For example, to view the information for the SUiTOviaji software package, 
perform the command: 



ff pkginfo -1 SUNWtnan 



PKGINST 

mm 

CATEGORY 
ARCH 
VERSION 
BASED I R 
VENDOR 
DESC 
PSTAMP 
INSTDATE 
HOTLINE 
STATUS 
FILES 




SUNWman 

On -Line Manual Pages 
system 
spare 

42.0,REV=35 
/usr 

Sun Microsystems, Inc. 
System Reference Manual Pages 
tinkertoym21003318 - 
Sep 27 2001 10:43 
Please contact your local service provider 
completely installed 
7033 installed pathnames 
3 shared pathnames 
84 directories 
81450 blocks used (approx) 



The last line identifies the size of the package. The number of blocks used 
defines how much space is needed on the disk to install the package. 




Note - A block is a 512-byte disk block. 



To determine how many packages are currently installed on disk, perform 
the command: 



rr pkginfo | wc -1 

657 



Displaying Information for Software Packages 

To view information about packages that are located on Solaris 9 Software 
1 of 2 CD-ROM, perform the command: 

pkginfo -d /cdram/cdrcm0/s0 /Solar is_5/ Product [more 
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Software groups located on Solaris 9 Software 1 of 2 CD-ROM are Core 
and End User. 

To view information about packages that are located on Solaris 9 Software 
2 of 2 CD-ROM, perform the command; 

pkginfo -d / cdroni / cdrcmO / Solaris_9 / Product |more 

The software groups located on Solaris 9 Software 2 of 2 CD-ROM are the 
Developer, Entire Distribution, and Entire Distribution Plus OEM Support 
software groups- 

Adding a Software Package 



When you add a software package, the pkgadd command copies the files 
from the installation media to the local system's disk and executes scripts 
to uncompress files. By default, the pkgadd command requires 
confirmation during the package add process. 

For example, to transfer the SUMWns 6m software package from a CD-ROM 
and install it on the system, perform the commands: 

# cd / cdrom/ cdrcmO / Solaxi s_9 /Ext r&Value /EaxlyAccess / Net s cap©_6 / Package s 
ft pkgadd -d , SUMWkis6m 

Processing package instance <SUNWns6m> from 

< cdrom/ sol_9_sparc_2 / Solar i s_9 /Ext raValue / Ear lyAc cess /Netscape_6 / Packages 
> 

Netscape 6 for Solaris - Messenger 
( spare ) 6. 2 , REV=2 0 , 2002 , 03 . 06 

Copyright 2002 Sun Microsystems, Inc. All rights reserved. 

Use is subject to license terms. 

Using </usr> as the package base directory. 

## Processing package information, 

## Processing system information. 

2 package pathnames are already properly installed. 
## Verifying package dependencies. 
## Verifying disk space requirements. 

## Checking for conflicts with packages already installed. 
## Checking for setuid/setgid programs. 

This package contains scripts which will be executed with super -user 
permission during the process of installing this package. 
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Do you want to continue with the installation of <SUNfofris6m> [y r n,?] y 

Installing Netscape 6 for Solaris - Messenger as <SUNWns6m> 

## Installing part 1 of 1. 
15038 blocks 

Installation of <SUNWns6m> was successful. 



Note - Certain unbundled and third-party packages are no longer entirely 
compatible with the latest version of the pkgadd command. These 
packages require system administrator interaction throughout the 
installation and not just at the very beginning. To install these older 
packages set the following environment variable: 
NONABI_SCRIPTS=TRUE . 

Checking a Package Installation 

The pkgchk command checks to determine if a package has been 
completely installed on the system. The pkgchk command also checks the 
path name, the file size and checksum, and the file attributes of a package. 
If the pkgchk command does not display a message, it indicates the 
package was installed successfully and that no changes have been made 
to any files or directories in the package. 

The following example checks the contents and attributes of the StMtfcarx 
software package currently installed on the system. 

ti pkgchk SUNWcarx 

# 

To list the fOes contained in a software package, use the option, 

For example, to list the files in the SUHWcarx software package, perform 
the command: 

# pkgchk -v SUNWcarx 

(same output omitted) 

/kernel 

/kernel/ drv 

/ kernel / drv / spar c v9 

/kernel/ drv / spare v 9 / arp 

/var 
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/var/ld 

/var/ld/64 

/ var /Id/ spar cv9 

To determine if the contents and attributes of a file have changed since it 
was installed with its software package, use the -p option, 

For example, to check the /etc /shadow file, perform the command: 

s pkgchk -p /etc/ shadow 

ERROR : /etc / shadow 

modtijne <06/19/01 03:55:23 PM> expected <ll/07/01 02:31:51 PM> actual 
file size <233> expected <247> actual 
file cksum <15950> expected <17155> actual 

The differences in mod time, file size, and checksum indicate that the 
original /etc /shadow file has changed in size since the initial Solaris OE 
software installation. 

The -1 option with the pkgchk command lists information about selected 
files that make up a package, 

1 ■ af y** 

For example, to list information about the /usr/bin/showrev file, 
perform the command: 

# pkgchk »1 -p /usr/bin/showrev 

Pathname : /usr /bin/ showrev 
Type: regular file 
Expected mode: 0755 
Expected owner: root 
Expected group: sys 
Expected file size (bytes) : 29040 
Expected sum ( 1 } of contents : 1417 

Expected last modification: Jun 24 11:54:29 FM 2001 
Referenced by the following packages: 

SUNWadmc 
Current status: installed 

The full path must be typed for the pkgchk command to return 
information about the file. 
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For example, the pkgchk command does not return any information if the 
/usr/bin/ path is removed from the previous example, 

■■■ pkgchk -1 -p showrev 

# 



Removing a Software Package 



The pkgrm command removes a software package from the system and 
deletes all of the files associated with that package, unless other packages 
share those files, 

By default, the pkgrm command requires confirmation to continue 
removing a package and issues a message to warn about possible package 
dependencies, If package dependencies do exist, the command again 
requires confirmation to continue with the package removal process. 

The following command removes the SUfJWapefuf software package from 
the system. 

# pkgrm SUNWapchr 

The following package is currently installed: 
SUNWapchr Apache Web Server (root) 

(spare) 11.9.0 ( REV=2002.01.18.00.45 



Do you want to remove this package? [y,n,?,q] y 



## Removing installed package instance <SUNWapchr> 

## Verifying package dependencies. 

WARNING: 

The <SUNWapchu> package depends on the package 
currently being removed; 
WARNING: 

The <SUNWapchd> package depends on the package 
currently being removed. 
Dependency checking failed. 

Do you want to continue with the removal of this package [y, n,?,q] y 

## Processing package information. 

## Removing pathnames in class <initd> 

/etc/rcS . d/K16apache 

/etc/'rc3 .d/S50apache 

/etc/rc2 .d/K16apache 

/etc/rcl .d/K16apache 
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/etc/rcO . d/K16apache 
/ et c / in i t . d / apache 

(output ommited for brevity) 

## Removing pathnames in class <preserve> 
/var < shared pathname not removed> 
/etc/rcS.d <shared pathname not removed> 
/etc/rc3.d < shared pathname not removed> 
/etc/rc2.d <shared pathname not removed> 
/etc/rcl,d <shared pathname not removed> 
/etc/rcO.d <shared pathname not removed> 
/etc/init.d <shared pathname not removed> 
/etc /apache / tomcat / server . xml -example 
/ et c / apache / t omc at 
/etc /apache / ht tpd . c onf - exampl e 
/etc /apache /README . Solaris 
/etc /apache 

/etc <shared pathname not removed> 
fc# Updating system information/ 

Removal of <SUNWapchr> was successful. 



Note - A file shared by two or more packages displays the message 
filename < shared pathname not removed>. The message is removed 
only when the hie is no longer shared, 



Adding Packages by Using a Spool Directory 

For convenience, copy frequently installed software packages from the 
Solaris 9 Software CD-ROM to a spool directory on the system. 

The default installation directory for packages that have been spooled, but 
not installed, is /var / spool/pkg. The pkgadd command, by default, 
looks in the /var/ spool /pkg directory for any packages specified on the 
command tine. 

Copying packages from the CD-ROM into a spool directory is not the 
same as installing the packages on disk. 
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To copy a package into the /var/spool/pkg directory, perform the 
command: 

I pkgadd -d /cdrowi/cdrcroO/sO/Solaxis_ 9 /Product -s spool SUNWensqr .u 

Transferring <SUNWensqr .u> package instance 

The -s option with the keyword spool copies the package into the 
/var/spool/pkg directory by default. 

To verify that the package exists in the spool director}', perform the 
command: 

# Is -al /var/spool/pkg 

to tal 6 

drtrcrwxrwt 3 root bin 512 Nov 7 13:53 . 

drwxr-xr-x 10 root bin 512 Oct 25 05:01: . . : 

clrwxr-xr-x 5 root other 512 Nov 7 13:53 SUNWensqr.u 

To remove software package? from a spool directory, use the pkgrm 
command with the -s option, 

-. 

pkgrm -s spool SUNWensqr,u 

The following package is currently spooled; 
SUNWensqr.u Ensoniq ES1370/1371/1373 Audio Device Driver (Root) , (32-bit) 
(spare. sun4u) 6 . 1, R£V=2001 . 05 . 04 . 09 . 44 : • 

Do you want to remove this package? y 

Removing spooled package instance <SUNWensqr .u> 

If alternative spooling directories; exist, specify which director}' to use by 
adding a directory path to the -s option. 

For example r to select the / export /pkg directory, perform the commands: 
rf pkgajdd / cdrom/ cdromO / sO / Solar is_9 / Product -s /export /pkg SUNWensqr-u 

|j pkgrm -s /export /pkg SUNWensgr.u 
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Reviewing Package Administration 



This section details the package administration tasks. 

Table 6-1 summarizes the commands used for package administration. 

Table 6-1 Package Administration Commands 



Command Name 


Description 


pkginfo 


Lists packages installed on the system or available 
on distribution media 


p kg add 


Installs packages 


pkgrm 


Removes packages 


pkgchk 


Verifies the attributes of the path names that belong 
to packages 



Table 6-2 summarizes the files and directories used in package 
administration. 

Tabl e 6-2 Pac kage Ad mini stra n on Files and Di rectories 



File or Directory 


Description 


/var/sadm/ instal 1 / contents 


A software package map of the entire system 


/opt/pJcgna/ne 


The preferred location for the installation of 
unbundled packages 


/opt/ pkgname / bin or / o p t. /b in 


The preferred location for the executable files of 
unbundled packages 


/ var / opt / pkgname or 
/ etc / op t / pkgname 


The preferred location for log files of unbundled 
packages 
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Performing the Exercises 

You have the option to complete any one of three versions of a lab. To 
decide which to choose, consult the following descriptions of the levels: 

« Level 1 - This version of the lab provides the least amount of 

guidance. Each bulk ted paragraph provides a task description, but 
you must determine your own way of accomplishing each task. 

« Level 2 - This version of the lab provides more guidance. Although 
each step describes what von should do, you must determine the 
commands (.and options) to input, 

• Level 3 - This version of the lab is the easiest to accomplish because 
each step provides exactly what you should input to the system. This 
level also includes the task solutions for all three levels. 
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Exercise: Manipulating Software Packages (Level 1) 



In this exercise, you use package-related commands to remove/ install, 
and spool packages. 



Locate the Solaris 9 Software CD-ROMs. Refer to the lecture notes as 
necessary to perform the tasks listed. 



Complete the following tasks: 

• Find the names of packages installed on your system that relate to 
manuals. List and record the status of, the install date of r the number 
of files used by, and the number of blocks used by the suNWman 
package. Obtain the same in forma lion from the spooled SUi«rian 
package on the correct Solaris 9 OE Software CD-ROM. Remove and 
reinstall the SUIvHtnan package, 

(Steps 1-6 in the Level 2 lab) 

.... '. ; .?<s .... 

• Remove the SUNWdoc package from the system. Attempt to access the 
online man pages. Spool the SUNWdoc package from the correct 
Solaris 9 OE software CD-ROM into the default spool area. Verify the 
presence of this package in the spool area, Add the SUNWdoc package 
to the system. Remove the SUNWdoc package from the spool area, 

(Steps 7-15 in the Level 2 lab) 



Preparation 



Tasks 




Performing Solaris 9 OE Package Administration 

Copyright 2003 Sun Microsysi&ms. Inc. All Rights Reserved. Sun Services. Revision A.2 



6-15 



Exercise: Manipulating Software Packages (Level 2) 



Exercise: Manipulating Software Packages {Level 2) 

In tills exercise, yon use package-related commands to remove, install, 
and spool packages. 

Preparation 

Locate the Solaris 9 Software CD-ROMs. Refer to the lecture notes as 
necessary to perform the tasks listed, 

Task Summary 

In tliis exercise, you accomplish the following: 

• Find the names of packages installed on yonr system that relate to 
manuals. List and record the status of, the install date of, the number 
of files used by, and the number of blocks used by the SUNWnan 
package. Obtain the same information from the spooled SIMMfrian 
package on the correct Solaris 9 OE Software CD-ROM, Remove and 
reinstall the SUNKfrnan package. 

• Remove the SUNwdoc package from the system. Attempt to access the 
online man pages. Spool the stJNWdoc package from the correct 
Solaris 9 OE software CD-ROM into the default spool area. Verify the 
presence of this package in the spool area. Add the SUNWdoc package 
to the svstem. Remove the SUNWdoc package from the spool area. 

Tasks 

Complete the following steps: 

1 . Insert the Solaris 9 Software 2 of 2 CD-ROM SPARC Platform Edition 
into the drive, 

2. Use the pkginfo command to search for packages currently on your 
system that are reiated to manuals. 

Which packages were listed? 

3. Display a long-format listing of the information for the SUNWman 
package installed on your system. What is listed for the status of, the 
install date of, the number of files used by, and the number of blocks 
used by this package? 
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4. Display a long-format listing of the information for the SUNWman 
package on the Solaris 9 OE Software 2 of 2 CD-ROM. Obtain the 
same information as in the previous step. 



Note - Steps 5 and 6 take several minutes to perform. 



5. Remove the SUNWman package from your system, and verify that it 
has been removed by trying to access the manual pages. 

6. Reinstall the SUNWman package from the Solaris 9 OE Software 2 of 2 
CD-ROM. Respond y to questions asked by the pkgadd command, 
Verify mat the manual pages work, 

7. Remove the SUNWdoc package from your system and answer yes to 
the remove questions. 

8> Are there any package dependencies related to removing this 
package? 

9, Eject the Solaris 9 Software 2 of 2 CD-ROM, and insert the Solaris 9 
Software 1 of 2 CD-ROM. Use the pkgadd command to spool the 
SUNWdoc package into the default Spool area. 

10, Use the pkginfo command with the appropriate options to verify 
the presence of the SUNWdoc package in the default spool area. 

1L Install the SUNWdoc package. Observe the messages, and verify that 
the package is installed from the /var/ spool /pkg directory. 

12. Remove the SUNWdoc package from the default spool area. 

13. Verify that the SUNWdoc package no longer exists in the spool area 
and that it is installed on your system. 

14 Eject the Solaris 9 Software 1 of 2 CD-ROM. 
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Exercise: Manipulating Software Packages (Level 3) 

In this exercise, you use package-related commands to remove, install, 
and spool packages. 

Preparation 

Locate the Solaris 9 Software CD-ROMs. Refer to the lecture notes as 
necessary to perform the tasks listed. 

Task Summary 

In this exercise, you accomplish the following; 

• Find the names of packages installed on your system that relate to 
manuals. List and record the status of, the install date of, the numher 
of files used by, and the number of blocks used by the SUNWtoan 
package. Obtain the same information from the spooled SUNVtoan 
package on the correct Solaris 9 OE Software CD-ROM. Remove and 
reinstall the SUNV&nan package. 

• Remove the suNWdoc package from the system. Attempt to access the 
online man pages. Spool the SUNWdoc package from the correct 
Solaris 9 OE software CD-ROM into the default spool area. Verify' the 
presence of this package m the spool area. Add the SUNWdoc package 
to the system. Remove the SUNWdoc package from the spool area, 

if. - K 1 

Tasks and Solutions 

Complete the following steps: 

1. Insert the Solaris 9 Software 2 of 2 CD-ROM SPARC Platform Edition 
into the drive. 

Use the pkginfo command to search for packages currently on your 
system that are related to manuals. 

anual 

Which packages were listed? 

SUNWman, SUNWmfman, SUNWoplSm, SUNWpl5nv and SUNWtltkm 

These packages contain the online manual pages, CDE motif manuals, Perl 
Reference manual pages. Peri 5 online manual pages, ami ToolTalk* M 
software manual pages, respectively, 
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3> Display a long-format listing of the information for the SUNWman 
package installed on your system. 

w pkginfo -1 SUNWman 

What is Listed for the status of, the install date of, the number of files 
used by, and the number of blocks used by this package? 

Status: Completely installed 

Install date: Should match the date and time wlwn you installed 

Solaris OE ou xjour system 

Number of files: xxxx installed path names, x shared directories, 
xx directories 

N timber of xxxxx 
blocks: 




4, Display a long-format listing of the information for the SUNWman 
package on the Solaris 9 OE Software 2 of 2 CD-ROM. Obtain the 
same information as in the previous step. 

# pkginfo -a /edanam/cdronaG/ Solar is_9/ Product -1 SUNWman 



Status: Spooled 
Install date: No install date indicated 

Number affiles: xxxx spooled path names, xx directories, x package 
information files 

Number of xxxxx 
blocks: 

5. Remove the SUNWman package from your system, and verify that it 
has been removed by trying to access the manual pages. 

# pkgrm SUNWman 

# pkginf o SUNWman 

ERROR: information for "SUNVSnan" was not found 
jj man Is 

No manual entry for Is. 
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6. Reinstall the SUNWman package from the Solaris 9 OE Software 2 of 2 
CD-ROM. Respond y to questions asked by the pkgadd command. 
Verify that the manual pages work. 

# pkgadd -d /ccbrcm/cdromO/ Sol aris_9 /Product SUNtonan 
r man Is 



The manual page for Is appears. 

7. Remove the SUNWdoc package from your system. 
f pkgrm SUNWdoc 

8. Answer yes to questions from the pkgrm command, 

9, Are there any package dependencies related to removing this 
package? 

Yes there arc. They are six other packages related to the SUNWdoc package. 

10, Eject the Solaris 9 Software 2 of 2 CD-ROM, and insert the Solaris 9 
Software 1 of 2 CD-ROM, Use the pkgadd command to spool the 
SUNWdoc package into the default spool area* 

I pkgadd -d /cGVom/cdroroQ/sQ/Solaris_9 /Product -s spool SUNWdoc 

U. Use the pkginf o command with the appropriate options to verify' 
the presence of the SUNWdoc package in the default spool area. 

pkginf o -d spool SUNWdoc 

system SUNWdoc 

P pkginf o -d /var/ spool /pkg -1 SUNWdoc 

PKGINST: SUNWdoc 
(further output oramited) 



12. Install the SUNWdoc package* Observe the messages, and verify that 
the package is installed from the /var/ spool /pkg directory. 

£ pkgadd SUNWdoc 

Processing package instance <SUNWdoc> from 
< / var / spoo 1 / pkg > 
(further output omitted) 

13. Remove the SUNWdoc package from the default spool area, 
£ pkgrm -s spool SUNWdoc 

14. Verify that the SUNWdoc package no longer exists in the spool area 
and that it is installed on your system* 

# pkginf o -d spool SUNWdoc 

ERROR: information for " SUNWdoc H was not found 
| pkg info -1 SUNWdoc 
PKGINST: SUNWdoc 
(further output omitted) 

15. Eject the Solaris 9 OE Software 1 of 2 CD-ROM. 
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Exercise Summary 



Discussion - Take a few minutes to discuss what experiences, issues, or 
discoveries you had during the lab exercises. 

# Experiences 

* Interpretations 

• Conclusions 

• Applications 
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Managing Software Patches on the 
Solaris 9 OE 



Objectives 



Upon completion of this module, you should be able to: 

• Describe the fundamentals of patch administration 

• Install and remove patches 

The following course map shows how this module fits into the current 
instructional goal. 

Installing Software 



. j 

Installing the j 


Performing 
Solaris .9 OE 




Managing 
Software 


- Solaris** 9 f 




Patches on 


OE | 


Package 
Administration 




the Solaris 9 


E 




OE 



Figure 7-1 Course Map 
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Preparing for Patch Administration 

The administration of patches involves installing or removing Solaris OE 
patches from a running Solaris OE + 

Introducing Solaris OE Patches 

A patch contains a collection of files and directories. This collection 
replaces existing files and directories that prevent proper execution of the 
software. Some patches contain product enhancements, 

The Solaris OE patch types include: 

• Standard patches - Patches that fix specific problems with the Solaris 
OE and other Sun hardware and software products. 

• Recommended patches - Solaris OE patches that fix problems that 
might occur on a large percentage of systems. 

• Y2K patches - Patches that ensure compliance of Sim products with 
the year 2000. 

• Patch clusters - A group of standard, recommended, security, or Y2K 
patches that have been bundled into a single archive for easy 
downloading and installation. 

• Maintenance update - A set of patches that have been tested 
together and packaged for one-step installation. Available to service 
contract customers, maintenance updates are designed to update the 
Solaris OE to a known, tested patch-level. The installation procedure 
takes much less time than installing the same patches individually. 

A patch is distributed as a director}' that is identified by a unique number. 
The number assigned to a patch includes the patch base code first, a 
hyphen, and a number that represents the patch revision number. For 
example, a patch directory named 105050-01, indicates that 1DB050 is the 
base code and 01 is the revision number* 

The Solaris 9 OE patches are in sip format, for example, 105050-01 .. zip. 
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Accessing Patch Documents 

Prior to installing patches on your system, you should review the patch 
documents available through the World Wide Web, patch update 
CD-ROMs, or anonymous FTP. 

To access patch documents through the World Wide Web, go to: 
http : / / sunsolve . sun . com 

Click Worldwide for a list of alternative sites by geographic areas, 

Anonymous FTP access to patch documents is available from 
sunsolve . sun , ccm Use your complete email address as a password, 
After the connection is complete, the publicly available patch documents 
are located in the /pub/ patches directory: 

Table 7-1 shows important summary documents that list all recommended 
patches for the Solaris OE, 

: . . :;:■:. 



Table 7-1 Patch Documents and Files 



Patch Document 


Contents 




Solaris9 . PatchReport 


A summary of all patches for the Solaris 9 OE release 


9_Recommended . README 


Instructions for how to install the recommended patch 
cluster for the Solaris 9 OE, as well as any important notes 
or warnings, special installation instructions, and usually a 
note to reboot the system 



When vou are reviewing patch documentation, start with the Patch 
Report document first. This report is divided into categories that include 
information about all patches for a Solaris OE release* 



Note - Not all patches available from Sun Microsystems must be 
installed. Only install the recommended patches, security patches, and 
those required to fix problems specific to your site* 
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Checking Patch Levels 

Before installing operating environment patches, you should know about 
patches that have been previously installed on a system. 

The showrev command and the patchadd command provide useful 
information about currently installed patches, 

I showrev -p 

Patch: 106793-01 Obsoletes: Requires: I nc ompa t ibles : Packages: SUNWhea 
# patchadd -p 

Patch: 106793-01 Obsoletes: Requires: Incompa titles : Packages: SUNWhea 



Note - Command output is the same far the patchadd -p and showrev 
-p commands; .however, the patchadd command takes longer to display 
patch information. The showrev command is a binary, and the patchadd 
command is a script. 



Historical information about all patches that are currently installed on a 
system and that can be uninstailed using the patchrm command is stored 
in the /var/sadm /patch directory. 

The following command lists the contents of the / var/sadm/ patch 
directory, 

# Is /vax/sadra/ patch 

107558-05 107594-04 107630-01 107663-01 107683-01 107696-01 
107817-01 107582-01 107612-06 107640-03 

Caution - Deleting files from the /var/sadm directory to make more 
space is a Solution Center call generator. The only way to correct the 
problems that occur is to restore the deleted files from backup tapes or to 
reload the software. 



Note - It is important to ensure that sufficient space has been allocated for 
the /var file system. Be sure that the /var file system is at least 
200 Mbytes in size to start with. There must be sufficient space for the 
/var/sadm director)- to grow as rikfwd softw are packages and patches are 
installed on the system. 
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Obtaining Patches 

Sun customers who have a maintenance contract have access to the 
SunSolve SM program's database of patches and patch information, 
technical white papers, the Symptom and Resolution database, and more, 
these are available using the World Wide Web or anonymous FTB 

A SunService SM program customer can request to receive the patch update 
CD-ROMs, which are released quarterly. 

Sun customers without maintenance contracts have access to a subset of 
the patches available through the SunSolve program. These patches are 
available at no charge and include important security and bug fix patches. 

To access patches through the World Wide Web, use the following 
Universal Resource Locators (URLs): 



http ; / /sunsolve . sun . co . jp - Japan 

ht tp : / / sunsolve . sun .se - Sweden 

http : //sunsolve. sun . ch - Switzerland 

http : / / sunsolve . sun, co . uk - United Kingdom 

The comprehensive set of patches and patch information is available to 
contract customers through the button labeled Login. The customer's 
assigned SunService program password is required to access this 
database. 

To access patches using FTP, use the ftp command to connect to: 



sunsolve • sun * com 




The ftp utility has many commands; however, only a few- are necessary 
for moving files from system to system, You can locate .and copy patches 
to the local system with a few basic FTP commands. 
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The following example shows the procedure for changing to me 
/var/tmp directory on the local system, connecting to the remote FTP site, 
locating a patch and its README file in the /pub/patches directory, and 
transferring both files to the local system's directory, 




Note - The default mode for an f tp connection is binary mode in Solaris 
9 OE, The default mode for an ftp connection in Solaris 8 or earlier 
versions is American Standard Code for Information Interchange (ASCII) 
mode. You use the bin command to set the FTP transfer mode to binary 
mode to transfer binary, image, or a non-text files in these earlier versions 
of the OE 

| cd /var/tmp 

■■■■ ftp s-Qiisolve.EunL.com 

Connected to sunsolve.sun.com. 
220- 

220-Welcome to the SunSolve Online FTP server. 
220- 

220- Public users may log in as anonymous, 
220- 

22 O-Con tract customers should use the following 2-tier login procedure: 
220- 

220- At the 1st login prompt: sunsolve 
220- passwd: sunmicro 

220- 

220-At the 2nd locsin prompt: <sunsolve login name>/< sunsolve passwd> 

220-example: myssID 'mypasswd 

220- 

220 -Public users may log in as anonymous; contract customers 
220-should use the standard sunsolve login and password, 
220-followed by their SunSolve account /password when prompted. 
220- 
220- 

220 sunsolveS FTP server ( Version wu-2.6.2{21) Thu Mar 14 14:48:19 MST 
2002) ready. 

Name ( sunsolve rusera) : anonymous 

331 Guest login ok, send your complete e-mail address as password. 
Password : yourpas sword 
230-Please read the file README 

230- it was last modified on Hon Aug 26 15:27:12 2002 - 113 days ago 

230 Guest login ok, access restrictions apply, 

ftp> cd /pub/patches 

ftp> get Solaris 9. Pat chReport 

200 PORT command successful. 
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150 Opening ASCII mode data connection for Solaris9 . PatchReport {8187 
bytes) . 

226 Transfer complete. 

local : Solaris9 . PatchReport remote : Solaris9 . PatchReport 

8432 bytes received in 4.9 seconds (1.7 Kbytes /s) 

ftp> nqjet 112605* 

mget 112605-01. zip? y 

200 PORT command successful. 

150 Opening ASCII mode data connection for 112605-01 .zip (95744 bytes), 
22 6 Transfer complete. 

local: 112605-01. zip remote: 112605-01 . zip 
96052 bytes received in 1 seconds (91 Kbytes/s) 
mget 112605. readme? y 
200 PORT command successful. 

150 Opening ASCII mode data connection for 112605 .readme (2198 bytes). 
226 Transfer complete. 

local: 112605 , readme remote: 112605 . readme 
2274 bytes received in 0.039 seconds (57 Kbytes/s) 
f tp> bye 




Note - To disable interactive prompting during multiple (mget) file 
transfers, you can begin a session using ftp - i si tename or use the 
prompt command at the f tp> prompt. 



Preparing Patches for Installation 



When patches are downloaded to the local system, you must place the 
patches in a temporary directory to prepare them for installation. The 
directory commonly used is the /var/ tmp directory. 



One of the common reasons for patch installation failure is directory 
permission or ownership problems. The /var / tmp directory is open to all 
and eliminates any of these types of problems. 

The Solaris 7, Solaris 8, and Solaris 9 OE patches are in zip format, for 
example, 105050-01 .zip. 

Use the unzip command to unpack the patch files, 
# /usr/ bin/ unzip 105050-01. zip 



Earlier versions of the Solaris OE used compressed tar files in a tar ■ Z 
format, for example, 101010-01 . tar. Z 
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Use the zcat command to uncompress the patch files and the tar 
command to create the patch directories. 



# / us r /bin/ zcat 105050-01. tar, Z | tax xvf 



Patch Contents 



Figure 7-2 shows the contents of a patch directory after it is extracted from 
the zip file. 



Q Patch 105050-ni 
— T~] sunWcsi: {Package containing files to be patched) 
— T] install 

~-Tj copyright 
1 — [j scripts (Optional) 
— Q pkgin.ro (New information for the / var ' s adm/ pkg / pks^name / p);g info file) 
— Q P ■< qma p (Path to new files and din? clones in the patch, appends to •• var aadro- i tis tall/ cor.tenir ) 
— Q) reloc (New files to be installed) 
— Q README. 105050-01 

— T~| SUNWhea (Package containing files to be patched) 



':f||: 



install 
j — Qj copyright 
1 — Q scripts (Optional) 
~Q pkginf o (New information for the ,'vax ■ satin/ pkg/pfcgj 
-Q pfcgmap {Path to new fries and directories in the patch) 
— Q re ioc {New files to be in stall ed ) 
Q ins taJLl , info {Optional) 
r *"0 5coucpatch 
■—•Q insitslipatch 



e/pkginf o file) 



Directory that might 
not be present 



Figure 7-2 An Extracted Patch Directory 
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Installing and Removing Patches 



The two most common commands for managing patches are: 

• pacchadd - Installs uncompressed patches to the Solaris OE 

• patchrm - Removes patches installed on the Solaris OE 

Additionally, you install cluster patches by using the ins tall_c luster 
command. You can also manage patches through the Solaris Management 
Console. 



When a patch is installed, the patchadd command calls the pkgadd 
command to install the patch packages. 

The following example shows the procedure for patch installation. This 
example assumes that the patch to be installed exists in the /var/tmp 
director)' and has been unzipped or uncompressed for installation. 



* patchadd 105050-01 

Checking installed patches, . . 
Verifying sufficient filesystem capacity (dry run method) 
Installing patch packages 

Patch number 105050-01 has been successfully installed. 
See /var /sadm/ patch/ 105050-01/log for details. 
Patch packages installed: 
SUNWhea 



Installing a Patch 




# cd /var/tng? 
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Figure 7-3 shows those components of the /var/sadm directory that are 
updated during the installation of patch 105050-01. 



sarim 

pkg 
—Pi SUNWhea 
— [2| pkginfo 
m -T~\ Save 

1—1 I 105050-01 

—Pi SUNWcsu 

— Q pkginf o (Updated by patch) 

Save 

Mri 105050-01 

* — Q undo . z (Archive of old files replaced by patch) 

Hj patch 

L-T] 105050-01 : 
I' 1 

— Q README. 105050-01 

!-Q log 



Figure 7-3 Updated /var / sadm Directories 

Error codes can be useful for troubleshooting problems encountered 
during installation. 



Some of the error codes found in the /usr/sbin/patchadd command are 
shown in Tnble7-2, 

Tab L e 7-2 Some /usr/sbin/patchadd Command Error Codes 



Number 


patchadd Error Codes 


0 


No error. 


1 


Usage error 


: 


An attempt to apply a patch that has already been 
applied- 
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Table 7-2 Some /usr/sbin/patchadd Command Error Codes 
(Continued) 



Number 


patchadd Error Codes 


3 


The effective user ID fEUITn is not root 


4 


An piH^pmrvt" fro mvp nHtHn;}] 1 1 1 i*^ fAilpci 

J il 1 CI 1 1. C J L I L J I L k 1 -If €\ \ %- \ * 1 1 L^ll L El 1 L 1 1 K. i_i 1 CI k. I r 


5 


1 L l%_ MriMCluU K. KJL 1 UL1 LCLL A C [ J. J V VI ■ 


6 


The patch is obsolete, 


7 


An invalid package directory. 


3 


An attempt to patch a package that is not installed, 


9 


Cannot access ,■ us r / sb i n / pkgactd { clien t problem). 


10 


Package validation errors. 


11 


An error occurred while adding a patch to the root 


12 


The patch script terminated due to a signal. 


13 


A symbolic link was included in the patch. 


14 


Not used. 


15 


The prepatch script had a return code other than 0. 


16 


The postpatch script had a return code other than 0, 


17 


A mismatch of the -d option occurred between a 
previous patch installation and the current one. 


18 


There is not enough space in the file systems that are 
targets of the patch. 


i ti 

W 


1 lv SSOFTINFO INST_RELlEASE file WOE not found. 


20 


A direct instance patch was required but was not 
found. 


21 


The required patches have not been installed on the 
manager. 


22 


A progressive instance patch was required but was not 
found* 


23 


A restricted patch is already applied to the package. 


24 


An incompatible patch was applied, 


25 


A required patch was not applied* 
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Table 7-2 Some /usr/sbin/patchadci Command Error Codes 
(Continued) 



Number 


patchadd Error Codes 


26 


The user-snecified hackout data cannot be found 


27 


The relative directory supplied cannot be found. 


28 


A pkginf o file is corrupt or missing. 


29 


Bad patch ID format. 


3a 


Dry run failures occurred. 


31 


The path given for the -C option was invalid. 


32 


You must be running the Solaris 2.6 OE to the Solaris 9 
OE 


33 


The patch file was formatted incorrectly or the patch 
file was not found. 


34 


An incorrect pstidi. spool directory was given. 


35 


A later revision was already installed. 


36 


You cannot create a safe temporary director} 7 . 


37 


An illegal baekout directory was specified. 



Removing a Patch 

When you remove a patch, the patchrm command restores all files that 
were modified or replaced by that patch, unless: 

• The patch was installed with the patchadd -d option (which 

i nstructs the patchadd command not to save copies of files being 
updated or replaced) 

• The patch is required by another patch 

• The patch has been obsoleted by a later patch 

The patchrm command calls the pkgadd utility to restore packages that 
were saved during the initial patch installation. 
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The following example shows how to remove a patch by using the 
patchrm command. 

9 patdizro 105050-01 

Checking installed packages and patches,.. 
Backing out patch 105050-01. . . 
Patch 105050-01 has been backed out. 
I 

Installing Patch Clusters 

The patch cluster provides a selected set of patches for a designated 
Solaris OE level and is conveniently wrapped for one-step installation. 
Patch clusters are usually a set of recommended, security, or Y2K patches. 

You should not install cluster patches on systems with limited disk space. 
Sun does not recommend installing cluster patches on systems with less 
than 10 Mbytes of available space in the /(roof), /usr, /vax, or /opt 
partitions. 

By default; the cluster installation procedure saves the base objects being 
patched. Prior to installing the patches, the cluster installation script first 
determines if enough system disk space is available in the 
/var/sadm/pkg directory to save the base packages and terminates if not 
enough space is available, 

You can override the save feature by using the -nosave option when you 
are executing the cluster installation script. If you use the -nosave option, 
you will not be able to back out individual patches if the need arises. 

You can remove individual patches that were installed by the patch 
cluster by using the patchrm command, The readme file is located in the 
specific patch directory under the /var/sadm/ patch directory after the 
patch has been installed. 
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To install a patch duster, perform the following steps: 

1. Be sure the patch cluster has been unzipped or uncompressed and 
extracted if the cluster was received as a tar . Z file. 

2. Decide on which method to use to install the cluster — the 
recommended default save option or the -nosave option. 

3. Change to the directory that contains the patch cluster, Read the 
CLUSTER_REAJDME file, which contains information about the bundled 
set of patches, including: 

• Cluster description 

• Patches included 

• Important notes and warnings 

• Sa ve and bac kt >u t op h on s 
m Special install instructions 

• Special patch circumstances 

• Any notices and other recommendations 



* WARNING* SYSTEMS WITH LIMITED DISK SPACE SHOULD *NOT* INSTALL PATCHES : 
(Other disk space warning messages omitted) 

Are you ready to continue with install? [y/n] :y 
Determining if sufficient save space exists... 
Sufficient save space exists, continuing. . . 
Installing patches located in /tmp/9_Recommended 
Using patch_order file for patch installation sequence 
Installing 113319-01. - - 
(other patch messages omitted) 

The following patches were not able to be installed: 
112875-01 
113023-01 

For more installation messages refer to the installation logfile: 
/ var / sadm/ ins t al l_da ta / Solar i s_9_Recommended_i og 
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Use ' /usr/bin/showrev -p' to verify installed patch-ids. 
Refer to individual patch README files for more patch detail. 
Rebooting the system is usually necessary after installation 
* 

4. Read each individual patch README file to determine if any 
additional steps are required to fully install any individual patch. 

5. Check the log file if more detail is needed, 

Reviewing the log provides information about why the patches 
listed above were not able to be installed: 

Tt more / var / sadm/ ins t all_dat a/ Solar is_9_Reccwffftended_log 

*** Install Solaris 9 Recommended begins Tue Dec 17 14: 47 til MST 2002 *** 
++* PATCHDIR = /tmp/9_Recommended *** 
(output omitted) 
installing 112875-01.,. 

Checkinq installed patches. . . 
Patch 112875-01 has already been applied. 
See patchadd(lM) for instructions. 

Installing 113023-01. . . 




Checking installed patches... 

One or more patch packages included in 

113023-01 are not installed on this system. 

(output omitted) 

# 

6> Reboot the system for all patches to take effect. 
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Performing the Exercises 

You have the option to complete any one of three versions of a lab, To 
decide which to choose, cons Lilt the following descriptions of the levels: 

• Level 1 - This version of the lab provides the least amount of 
guidance. Each bulleted paragraph provides a task description, but 
vou must determine vour own wav of accomplishing each task. 

• Level 2 - This version of the lab provides more guidance. Although 
each step describes what you should do, you must determine the 
commands (and options) to input. 

• Level 3 - This version of the lab is the easiest to accomplish because 
each step provides exactly what you should input to the system. This 
level also includes the task solutions for all three levels. 
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Exercise: Maintaining Patches (Level 1) 

In this exercise, you transfer a patch from a classroom server, apply the 
patch, and then remove it 

Preparation 

Your instructor should provide directions for accessing a patch on a server 
that is available to systems in the classroom, Refer to the lecture notes as 
necessary to perform the tasks listed. 



Tasks 




Complete the following tasks: 

• Create a directory to hold patches, Use the ftp command to transfer 
a patch horn a classroom server into the director}' you create. Unzip 
the patch. Verify that no patch has been applied to your system* 
Verity that the /var/sa dm/ patch directory is empty. 

• Read the README file associated with the patch to verify which 
Solaris OE release is appropriate for the patch. Add the patch, and 
verify mat it is installed in the /var/sadm/ patch directory View the 
log hie for thus patch, 

• Remove the patch you just installed, and verify that it is no longer 
applied to the system. 
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Exercise: Maintaining Patches (Level 2) 

In this exercise, you transfer a patch from a classroom server, apply the 
patch, and then remove it 

Preparation 

Your instructor should provide directions for accessing a patch on a server 
that is available to systems in the classroom. Refer to the lecture notes as 
necessary to perform the tasks listed. 

Task Summary 



this exercise, you accomplish the following: 

Create a directory to hold patches. Use the ftp command to transfer 
a patch from a classroom server into the directory you create- Unzip 
the patch. Verify that no patch has been applied to your system. 
Verity that the /var /sadnv patch directory is empty 

Read the REAEME file associated with the patch to verify which 
Solans OE release is appropriate for the patch. Add the patch, and 
verify that it is installed in the / var / s adm / patch directory View the 
log file for this patch. 

Remove the patch you just Installed, and verify that it is no longer 
applied to the system. 




In 



7-18 



Intermediate System Administration for the Solaris™ 9 Operating Environment 
Copyright 2003 Sun Microsystems, inc. All Rights Reserved, Sun Services, Revision A. 2 



Exercise: Maintaining Patches (Level 2) 



Tasks 

Complete the following steps: 

1, Create a directory to hold patches. Use the binary transfer mode of 
the ftp command to transfer a patch from a classroom server into 
the directory you created. Your instructor should provide 
information about where to find a patch on the server. Close your 
ftp connection when you are finished. 



Note - The default mode for an ftp connection is binary mode in 
Solaris 9 OE. The default mode for an ftp connection in Solaris 8 or 
earlier versions is ASCII mode. You use the bin command to set the FTP 
transfer mode to binary mode to transfer binary, image, or an non-text 
files in these earlier versions of the OE. 



2. 
5. 



8- 

9; 



Use the unzip command to extract the patch from the zip archive. 

Use the patchadd command to determine if any patches are 
currently installed on your system, 

Verify that the /var/sadm/patch directory is empty, 

Read the README file that is associated with the patch you unzipped. 
Verify the Solaris OE release for which the patch is required. 



Solaris OE release: 
Add the patch. 

Verify- that the patch is installed. What are the packages that the 
patch affects? 

Examine the patch installation log. 

Remove the patch you just installed. Verify that the patch is no 
longer installed. 
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Exercise: Maintaining Patches (Level 3) 

In this exercise, you transfer a patch from a classroom server, apply the 
patch, and then remove it 

Preparation 

Your instructor should provide directions for accessing a patch on a server 
that is available to systems in the classroom. Refer to the lecture notes as 
necessary to perform the tasks listed. 

Task Summary 

In this exercise, you accomplish the following: 

• Create a directory to hold patches/ Use the f tp command to transfer 
a patch from a classroom server into the directory you create. Unzip 
the patch. Verify that no patch has been applied to your system. 
Verify that the /vax/ sadm/ patch directory- is empty. 

• Read the README file associated with the patch to verify which 
Solaris OE release is appropriate for the patch, Add the patch, and 
verily that it is installed in the /var/sadm/ patch directory. View the 
log file for this patch, 

• Remove the patch you just installed, and verify that it is no longer 
applied to the system. 
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Tasks and Solutions 

Complete the following steps: 




Note - The default mode for an f tp connection is binary mode in 
Solaris 9 OE. The default mode for an ftp connection in Solaris 8 or 
earlier versions is ASCII mode. You use the bin command to set the FTP 
transfer mode to binary mode to transfer binary, image, or an n on- text 
files in these earlier versions of the OE. 

1 > Create a directory to hold patches. Use the binary transfer mode of 
the ftp command to transfer a patch from a classroom server into 
the directory you created. Your instructor should provide 
information about %vhere to find a patch on the server Close your 
ftp connection when you are fin t shed. For example: 

# cd /var/tirrp 

I ftp instructor 

(connection and login messages) 
ftp> cd /export/patches 
ftp> get 112875-01. zip 

(ftp messages) 
f tp> by* 
221 Goodfcye. 
| 

2> Use the unzip command to extract the patch from the zip archive, 
for example: 

# unzip 112875-01. zip 

Archive: 112875-01 . zip 

creating; 112875-01/ 
inflating; 112875-01/ .di Patch 
inflating; ll!2&75-01 /pa t chin f o 

creating: 112875-01/SUNWrcmds/ 
inflating; 112 875 -01/ SUNWrcmds /pkgmap 
inflating; 112875-01/SUNWronds/pkginf o 

crea t ing ; 112875-01/ SUNWrcmds / ins tal 1 / 
inflating : 112875-01/SUNWrcmds/ins tall/ checkins tall 
inflating : 112 875 -01 /SUNWrcmds /ins tall /copyright 
inflating: 1 12 875-01/ SUI^Wrcmds/install/i .none 
inf la t ing : 112875-01/ SUNWrcmds / ins tall /patch_checkins tal 1 
inf la ting : 112875-01/ SUNWrcmds / ins tal 1 /pa tch_pos t ins tall 
inflating ; 112875-01/ SUNWrcmds /ins tal 1 /pos tins tal 1 
inflating: 112875 -01 /SUNWrcmds /ins tal 1/preins tall 

creating: 112875-01/SUNWrcmds/reloc/ 
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creating: 112875-01/SUNWrcmds/reloc/usr/ 

creating: 112875-01/SUTMrcinds/reloc/usr/lib/ 

creating : 112 875-01 / SUNWrcmds / reloc /usr / lib/netsvc / 

cr ea t ing : 112875-01/ SUNWrcmds / reloc /usr /lib/ ne tsvc / rwal 1 / 

inflating: 112 87 5-01 /SUNWrcmds /reloc /usr/ lib/netsvc /rwall/rpc .rwalld 

inflating: 1 12 875-0 1/REAEME. 112875-01 

# 

3. Use the patchadd command to determine if any patches are 
currently installed on your system. 

# patchadd -p 

The patchadd command should display a message. 

4. Verify that the /var/sadm/ patch directory is empty. 

# Is /var/sadm/patch 



5. Read the REMME file that is associated wifl\ the patch you unzipped. 
Verify the Solaris OE release for which the patch is required. 

$ more 112875-01 /README. 112875-01 

Patch-ID* 112875-01 

Keywords: security rpc.rwalld string 

Synopsis: SunOS 5.9: patch /usr/ lib/netsvc / rwal 1 / rpc . rwalld 
Date: Jun/21/2002 
(output omitted) 

6. Add the paich. 

tt patchadd 112875-01 

Checking installed patches. ♦ > 

Verifying sufficient f ilesystem capacity (dry run method) . . . 



Installing patch packages... 

Patch number 112875-01 has been successfully installed. 
See /var/sacWpatch/112875-Gl/log for details 
Patch packages installed; 
SUNWrcmds 

# 

7. Verify that the patch is installed. What are the packages that the 
patch affects? 

# patchadd -p 

Patch: 112875-01 Obsoletes: Requires: Inconpatibles : Packages: SUNWrcmds 
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8* Examine the patch installation log file. 

# cd /var/sadm/patch/112875-01 

# more log 

(output omitted) 

Installation of <SUNWrcmds> was successful. 

9. Remove the patch you just installed. Verify that the patch is no 
longer installed. 

I cd 

# patchrm 112875-01 

Checking installed patches. . , 
Backing out patch 112875-01,.. 
Patch 112875-01 has been backed out. 
ft patchadd -p 

The patchadd -p command should not contain any reference to 
112875-01. 
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Exercise Summary 




Discussion - Take a few minutes to discuss what experiences, issues, or 
discoveries you had during the lab exercises, 

• Experiences 

• Interpretations 

• Conclusions 

• Applications 
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Executing Boot PROM Commands 



Objectives 



. : 



Upon completion of this module, you should be able to; 

Identify boot programmable read-only memory (PROM) 
fundamentals 



Use basic boot PROM commands 
Identify the system's boot device 
Create and remove custom device aliases 



View and change nonvolatile random access memory (NVRAM) 
parameters from the shell 

* Interrupt an unresponsive system 

The following course map shows how this module fits into the current 
instructional goal 

Performing System Boot Procedures 



Executing 
Boot PROM 
Commands 



Performing 
Boot and 
Shutdown 

Procedures 



Figure 8-1 Course Map 
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Introducing Boot PROM Fundamentals 



All Sun systems have resident boot PROM firmware that provides basic 
hardware testing and initialization prior to booting. The boot PROM also 
enables you to boot from a wide range of devices, In addition, there is a 
user interface that provides several important functions. 

The Sun boot PROM has access to a standard set of generic device drivers. 
The system needs these drivers to access and control the buses and the 
boot device to boot the system properly. 

Ail versions of the OpenBoot rM architecture allow a third-party board to 
identify itself and load its own plug-in device driver. Each device 
identifies its type and furnishes its plug-in device driver when requested 
by the Open Boot PROM during the system hardware configuration phase 
of the boot process. 




Figure 8-2 shows the identification process. 
System Board 




J 



Input/Output (I/O) Bus 





r 



\ / 

Third-party I/O Bus Card 



Figure 8-2 Third- Party Device Identification Process 
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Goal of the OpenBoot™ Architecture Standard 



The overall goal of the Institute of Electrical and Electronics Engineers 
(IEEE) standard for the OpenBoot architecture is to provide the 
capabilities to: 

• Test and initialize system hardware 

• Determine the system's hardware configuration 

• Boot die operating environment 

m Provide an interactive interface for configuration, testing, and 
debugging 

• Enable the use of third-party devices 



Boot PROM 




Each Sim system has a boot PROM chip. This 1- Mbyte chip is typically 
located on the same board as the central processing unit (CPU). Boot 
PROM chips are usually found in a pluggable socket on older systems* As 
of the 3. a PROM, they are permanently soldered to the main system 
board. 



The Ultra 1 * 1 workstations use a reprogrammable boot PROM called a 
flash PROM {FPROM). The FPROM allows you to load new boot program 
data into the PROM by using software, instead of having to replace the 
chip. A CD-ROM distributes these updates, 

Desktop systems have a write-protect jumper that must be moved before 
you can write to the PROM. You have to move the jumper because the 
default position is write-protect. Refer to the Flush Programming Manual far 
Ultra Ve$ktop Systems, part number 802-3233-17, for the jumper location on 
your system. 



Caution - Many systems have the jumper under an installed frame buffer 
or other removable card, Be careful when removing or replacing this card. 

The main functions of the boot PROM are to test the system hardware and 
to boot the operating environment. The boot PROM firmware is referred 
to as tlu- monitor program. 
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The boot PROM firmware controls the operation of the system before the 
operating environment has been booted and the kernel is available, The 
boot PROM also provides the user with a user interface and firmware 
utility commands, known as the FORTH command set. Commands 
include the boot commands, diagnostics commands, and commands to 
modify the default configuration. 



Note - The boot PROM does not understand the Solaris™ Operating 
Environment (Solaris OE) file systems or files. It handles mainly hardware 
devices. 



Currently/ there are five generations of Sun boot PROMs, Each generation 
has its own base revision number, as described in the following list: 

1,.t The first boot PROM used on SPARC® systems, 

2..v The first OpenBoot PROM, updated by replacing the 

application -specific integrated circuits (ASICs). 

3.,v The OpenBoot PROM non-removable ASIC, updated by 

flash. It was the first 64-bit capable PROM. This PROM was 
introduced with the Ultra 1 workstation and used with 
UltraSPARC 1 and UltraSPARC II workstations and 
servers. 

•4, X Used in Sun Blade™ and Sun Fire™ entry -level and 

mid-range workstations and servers. Used in 
UltraSPARC^ Hi and UltraSPARC III workstations and 
servers, such as Sun Blade 150 and 2000 workstations and 
Sun Fire 280R r 480R, vSSOz servers. 

5.x Used in mid-range and high-end servers using 

UltraSPARC III microprocessors, such as the Sun Fire 3800, 
Sun Fire 4800, Sun Fire 4810, Sun Fire 6800, Sun Fire 12K 
and Sim Fire 15K servers. 

To determine which revision of OpenBoot PROM is running on the 
system, perform the command: 

& /usr/platf orm/ l uname -m 1 /sbixi/prtdiag -v 
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NVRAM 



Another important hardware element in each Sim system is the NVRAM 
chip. This removable chip is often located on the main system hoard- 

The NVRAM module contains the electronically erasable programmable 
read-only memory (EEPROM). The EEPROM stores user-configurable 
parameters that have been changed or customized from the boot PROM's 
default parameters settings. This behavior gives you a certain level of 
flexibility in configuring the system to behave in a particular manner for a 
specific set of circumstances. A single lithium battery within the NVRAM 
module provides batter}' backup for the NVRAM and the clock, 

The NVRAM contains editable and noneditable areas. The noneditable 
area includes the following: 

m The Ethernet address, such as ; 0 ; 20 ? Bd : 6f : Sb 

• The system host ID value, such as 805d6f9e 

The editable area includes the folio wing: 

• The time-of-day (TOD.) clock value 

• The configuration data describing system operating parameters 

• A diagnostic mode switch that enables or disables power-on self -test 
(POST) 

• The device name and the path to the default boot device 

• A location for customized programming that is used during the boot 
process 




Note - Remember to retain the NVRAM chip, because it contains the host 
ID. Many licensed software packages are based on the system host ID. 
The NVRAM chip has a yellow sticker with a bar code on it. If the chip 
fails, Sun can replace the chip if given the numbers below this bar code. 
The replacement chip has the same host ID and Ethernet address. It can be 
plugged into the same location on the motherboard as the chip it is 
replacing, 
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Figure 8-3 shows the basic elements of the Boot PROM and NVRAM, 



Power-on 
Self-test 
(POST) 



Generic 
Device Drivers 



User Interface 
Commands 



Default 
Parameters 



Configuration 
Information 



EEPROM 



Time of Day 



Ethernet 
Address 



Host ID 



H'l 



Battery 



Binary Machine 
Instructions 



Figure 8-3 Basic Elements of the Boot PROM and NVRAM 
POST 



When a system's power is turned on, a low -lev el POST is initiated. This 
low-level POST code is stored in the boot PROM and is designed to test 
the most basic functions of the system hardware. 

At the successful completion of the low -level POST phase, the boot PROM 
firmware takes control and performs the following initialization sequence: 

* Probes the memory and then the CPU 

# Probes bus devices, interprets their drivers, and builds a device tree 

• Installs the console 



After the boot PROM initializes the system, the banner displays on the 
console. The system checks parameters stored in the boot PROM and 
NVRAM to determine if and how to boot the operating environment 
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Controlling the POST Phase 

One of the first tests that POST runs is to check to determine if a keyboard 
is connected to the system and if a Stop-key option is present, 



Note - You can control the POST phase through the Sun keyboard only. 

The Stop key is located on the left side of the keyboard, To enable various 
diagnostic modes, hold down the Stop key simultaneously with another 
key. The Stop-key sequences have an effect on the OpenBoot PROM and 
define how POST runs when a system's power is turned on. The 
following is a list of the Stop-key sequences; 

• Stop-D key sequence - Hold down the Stop and D keys 

simultaneously while system power is turned on, and the firmware 
automatically switches to diagnostic mode. This mode runs more 
extensive POST diagnostics on the system hardware. The OpenBoot 
PROM variable diag- switch? is set to true, 

See Figure 8-4 on page 8-7 to show the effect of the variable 
diag-switch?. 





Figure 8-4 Post Diagnostics 



Note - The Stop-D key sequence is not available on a serial port terminal. 
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• Stop-N key sequence - Hold down the Stop and N kevs 
simultaneously while the system power is turned on to set the 
NVRAM parameters to the default values. When you see the light 
emitting diodes (LEDs) on the keyboard begin to flash, you can 
release the keys, and the system should continue to boot, 

Incorrect NVRAM settings can cause system boot failure. For 
example/ during a flash PROM download, if a power failure occurs, 
some of the contents of the NVRAM can become unusable. 

If the system does not boot and you suspect that the NVRAM 
parameters are set incorrectly, the parameters can easily be changed 
to the default values. 

• Stop -A key sequence - Hold down the Stop and A keys 
simultaneously to interrupt any program that is -running at the time 
these keys are pressed and to put the system into the command entry 
mode for the OpenBoot PROM. The system presents an ok prompt 
for the user, which signifies it is ready to accept OpenBoot PROM 
commands. 



Caution - The Stop- A key sequence, as a method for getting to the ok 
prompt, is not recommended unless there is absolutely no alternative. The 
Stop- A key sequence can cause Solans OE file system corruption which 
can be difficult to repair. 



Disabling the Abort Sequence 

As a system administrator, you might want to disable the abort key 
sequence on a system to prevent possible corruption of a file system or to 
provide tighter security. 

To disable the abort key sequence, edit the /etc /default /kbd file. Inside 
the file, the statement KEYBQARD_ABORT=disable is commented out. 
Remove the comment from in front of the value, save the file, and execute 
the command kbd -L When you have completed these steps, the system 
allows Stop- A key sequence only during the boot process. 

You can also configure the system to change the keyboard abort sequence 
to an alternate keystroke. Review the man page for the kbd command for 
more information. 
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Displaying POST to the Serial Port 



As the system administrator, you can attach a terminal to the seriaJ port of 
a system to capture a far greater amount of information from the POST 
output. 

When the power is turned on, POST looks for a keyboard, If there is no 
keyboard present, POST diverts system output to serial port A. 

POST runs more extensive tests when the system is in diagnostic mode 
With the PROM parameter diag- switch? set to true. 

Be sure to attach the correct type of null modem cable for your system 
type to serial port A, 

Some systems require a special adapter cable, Connect the other end of 
the cable to the modem port of the American Standard Code for 
Information Interchange (ASCII) terminal, as shown in Figure 8-5. 




Transmit data 
Receive data - 
Ground 



- Transmit data 

- Receive data 
Ground 



ASCII 
Terminal 

Figure 3-5 



Serial Port Connection to a Sun Workstation 




Ultra 
Workstation 



The roll owing example is the POST output from a Sun Blade™ 1000 
workstation: 

Partial Post Output Listing 

@(#) 4.0 Version 29 created 2000/07/12 16:46 

Clearing TLBs Done 

Reset: 0000.0000.0000.0010 SPOR 

Loading Configuration 

Membase: 0000.0000.0000.0000 

MemSize: 0000.0000.2000.0000 

Init CPU arrays Done 

Init E$ tags Done 

Setup TLB Done 

MMUs ON 

Block Scrubbing Done 
Copy Done 

PC = 0000. 07ff.f000, 3138 
Decoirpressing Done 
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Size = 0000. 0000. 0006. e3b0 
ttya initialized 
Start Reason: Soft Reset 
System Reset: (SPOR) 

Probing gptwo at 0,0 SUNW, UltraSPARC- II I (750 MHz @ 5:1, 8 MB) 

memory-con trol ler 
Probing gptwo at 1,0 Nothing there 
Probing gptwo at 8,0 pci pci upa ppm 
Loading Support Packages: kbd- translator 

Loading onboard drivers: ebus flctshprom bbc ppm i2c dimm-fru dimm- f ru 
dinm-fru dimm-fru dimm-fru dimm-fru dimm-fru dimm-fru nvram idprom 
i2c cpu-fru temperature fan- control card- reader mother boar d-fru 

Memory Conf iguration i 

Segment Q Base: 0 Size: 512 MB (2-Way) 

Probing /upa£8, 480000 Device 0,0 Nothing there 
Probing /upa@8, 480000 Device 1,0 Nothing there 
Probing /pci@8, 600000 Device 4 SUNW,qlc fp disk 
Probing /pci@8, 600000 Device 1 Nothing there 
Probing /pci@8, 700000 Device 5 nietwork f irewire usb 
dev-descrip 
next- add 
node made 

Probing /pci@8 , 700000 Device 6 scsi disk tape sc si disk tape 
Probing /pci@8, 700000 Device 1 Nothing there 
Probing /pci@8, 700000 Device 2 Nothing there 

4 0* 

{UltraSPARC- III ) , Keyboard Present 
OpenBoot 4,0, 512 MB memory installed, Serial #12134217. 
Ethernet address 8 : 0 :20:b9: 27 : 49, Host ID: 80b92749. 
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Using Basic Boot PROM Commands 

The boot PROM monitor provides a user interface for invoking Open Boot 
commands. 



Note - The ok prompt indicates that the Solaris OE is currently not 
running. 



Table 8-1 shows some of the commands typically entered at the ok 
prompt. 

Table 8-1 Typical Commands Used at the ok Prompt 



Command 


Description 


banner 


Displays the power-on banner 


boot 


Boots the system 


help 


Lists the main help categories 


printenv 


Displays all parameters' current and default 
values 


setenv 


Sets the specified NVRAM parameter to some 
value 


reset-all 


Resets the entire system; similar to a power cycle 


set -defaults 


Resets all parameter values to the factory 
defaults 


sifting £&xt 


Displays the FORTH commands containing text 


.registers 


Displays the contents of the registers 


probe- scsi 


Identifies the devices on the internal Small 
Computer System Interface (SCSI ) bus 


probe-scsi-all 


Identifies the devices on all SCSI buses 


probe- ide 


Identifies devices on the internal integrated 
device electronics (IDE J bus 


probe-f cal-all 


Identifies devices on all Fibre Channel loops 


show-devs 


Displays the entire device tree 


devalias 


Identifies the current boot device alias for the 
system 
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Table 8-1 Typical Commands Used at the ok Prompt (Continued) 



nvalias 


Creates n new device alias name 


nvunal i as 


IxcITKJVtrri ri CltrVlLE 1 ctLlct^] Jinlllc 


show- disks 


Displays and allows a selection of device paths 
for the disks to be used for nvalias 


sync 


Mdnuailv all erupts to flush memory tind 
synchronize file systems 


test 


Rims self-tests on specified devices 



Identifying the System Boot PROM Version 

The banner command lists useful information about the system, such as 
the model name, the boot PROM version number (for example, 1.*-, 2.x f 
3.x f 4,x, or 5.x), the amount of memory, the Ethernet address, and the host 
ID. 

The following example shows output from the banner command. 

ok banner 

Sun Ultra 5/10 UPA/PCI (UltraSPARC- II i 360MHz), Keyboard Present 
OpenBoot 3.31, 128 MB (50 ns) memory installed, Serial #11888271. 
Ethernet address 8:0 :20:b5:66:8f, Host ID: 80b56'68f. 

Booting the System 

Use the boot command to boot the Solaris OE from the ok prompt. This 
command has several options available for booting the system in different 
situations 

The format for the boot command is: 
ok boot devi ce_name - options 

Enter the boot command at the ok prompt to boot the system to 
multiuser mode automatically 

ok boot 
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The following list describes the options for the boot command: 

• -s - Boots the s}/$tem to a single-user mode and asks the user for the 
root password. 

ok boot -s 

ok boot cdrom -s 

• -a - Boots the system interactively. Use this option if an alternative 
file needs to be executed during boot. The boot program asks for the 
following information. 

ok boot -a 

Enter filename [ kernel /sparcv9 /unix] : 

Enter default directory for modules [ /platform/ SUNW, Ultra- 5_10/ kernel 

/plat form/ sun4u/ kernel /kernel /usr/ kernel] : 

Name of system file [etc /system! : 

root file system type [ufsl : 

Enter physical name of root device: 

• -r - Performs a reconfiguration boot. Use this option to find a newly 
attached device and to create new device entries in the / devices 
and /dev directories. It also updates the /etc/patn_to_inst file. 

ok boot -r 

» -v - Boots the system while displaying more detailed device 

information to the console. Use mis option to troubleshoot problems 
during the boot process. You can use this option with other options, 

ok boot -v 

• . • . 

ok boot -rv 
ok boot -sv 
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Accessing More Detailed Information 

You use the help command to obtain help on the main categories in the 
Open Boot fi i ni ware. 

The following is an example of the help output from an Ultra 5 
workstation that is running OpenBoot PROM version 331: 

ok help 

Enter 'help command-name' or 'help category-name' for more help 
(Use ONLY the first word of a category description) 
Examples: help system -or- help nvramrc 
Categories : 

boot (Load and execute a program) 
nvramrc (Store user defined commands) 
system configuration variables (NVRAM variables) 
command line editing 
editor (nvramrc editor) 
resume execution 
devaliases (Device aliases) 
diag (Diagnostics commands) 
ioredirect (I/O redirection commands) 
misc (Miscellaneous commands) 



The help command listing provides a number of other keywords that you 
can use to view further details. 

For example, to view specific information for one of the main categories 
listed in the preceding example, perform one of the following commands: 



ok help boot 
ok help nvramrc 
ok help diag 
ok help misc 
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Listing NVRAM Parameters 



ok: print env 

Variable Name 



You use the printenv command to list aU the NVRAM parameters. If the 
parameter can be modified, the printenv command displays its default 
setting and current setting. 

The following example shows output from the printenv command. 
Value Default Value 



tpe- link- test? 
so s i - in i t ia t or - id 
keyboard- c 1 i ck? 
keymap 

ttyb-rts-dtr-of f 

t tyb- i gnor e- cd 

ttya-rts-dtr-of f 

ttya- ignore-cd 

ttyb-mode 

ttya -mode 

pci a -probe- list 

pcib-probe-list 

mfg-mode 

diag- level 

#power- cycles 

ou tpu t - devi ce 

input - devi ce 

boo c-command 

auto-boot? 

diag- device 

boot-device 

1 oc a 1 -mac - addr e ss ? 

scr een- # c o 1 umns 

screen- #rows 

use-nvr amr c ? 

nvramrc 

securi ty-mode 

security-pas swo rd 

securi ty- #badlogins 

diag-switch? 

ok 




ilf ,0 



0 

false 



screen 

keyboard 

boot 

true 

net 

disk net 

false 

80 

34 

false 



false 



You can also use the printenv command to display a single parameter 
and its values. 



Executing Boot PROM Commands 

Copyright 2003 Sun Microsystems, Inc. All Rights Reserved. Sun Services, Revision A.2 



8-15 



Using Basic Boot FROM Commands 

For example, to display only the boot -device parameter, perform the 
command: 

ok print env boot -device 

boot-device - disk net 

The possible values of the boot -device parameter include disk, net, and 
cdrora 



Note - Some Open Boot PROM parameters, such as auto -boot?, end in a 
question mark, If an Op en Boot PROM parameter ends in a question mark, 
the parameter value is typically either true or false. 

Changing NVRAM Parameters 

You use the setenv command to change the current vaJues assigned to 
NVRAM parameters. 

If the au to ^boot? parameter is set to true, the system boots 
automatically. If it is set to false, the system stops at the ok prompt. 

The following example changes the auto -boot? parameter from its 
default setting of true to the value of false. 

ok print env auto -boot? 

auto -boot? = true 
ok 

ok setenv auto-boot? false 

auto-boot? &i false 

The reset-all command halts the system, clears all buffers and registers, 
and performs a software simulated power-off/ power-on of the system* 

ok reset -all 

Resetting ♦ . . 



Note - The reset -all command clears system registers, which is 
required on a system with a PROM 3,.v or higher before you can use the 
probe command or perform other tests. 
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Restoring Default NVRAM Parameters 

You use the set -defaults command to reset all NVRAM parameters to 
their default values. It affects only parameters that have assigned default 
values. 

ok set -defaults 

Setting NVRAM parameters to default values, 
ok 

To reset a specific parameter to its default value, use the set-default 
command followed by the parameter name. 

ok set-default parameter-name 

For example, to reset the diag- level parameter, perform the command: 



ck set -default diag- level 



'II!:. 



To restore the default NVRAM parameters when you are starting the 
system, hold down the Stop-N key sequence while the system power is 
turned on. 

When the LEDs on the keyboard begin to flash, release the keys, and the 
svsteni continues to boot. 



Displaying Devices Connected to the Bus 

To identify the peripheral devices currently connected to the system, such 
as disks, tape drives, or CD-ROMs, use the probe command. 

To identify the various probe commands that are available with your 
system, use the sifting command. The sifting command is useful for 
finding OpenBoot PROM commands when you do not know the exact 
command syntax. 

For example, to find the probe commands available, perform the 
command: 

ok sifting probe 

(f006c954) probe-all (f006c5a0) probe-all (fOG6c378) probe-ide 

(f006cle8) probe- pci -slot (fQ06bc8c) probe-scsi 

(f006bd78) probe-scsi -all (f0060fe8) probe-pci 
( ou tpu t trunca ted ) 
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The most common probe commands are the probe- scsi command, the 
probe-scsi-all command, and the probe- ide command. 

Systems that contain the Fibre Channel- Arbitrated Loop (FOAL) Gigabit 
Interface Converters (GBICs) use the probe- fcal -all command. 



Caution - The following warning message might be displayed if you 
invoke the probe commands on Sun systems that contain a boot PROM 
that is version 3..r and above. 




This command may hang the system if a Stop-A or halt command has been 
executed. Please type reset -all to reset the system before executing this 
command. 

Do you wish to continue? (y/n) n 

To avoid having your system hang, perform the commands: 

ok setenv auto-boot? false 
ok reset -all 

One method you can use to tell if the system might hang during a probe 
command is to use the .registers command. 

ok .registers 

Normal Alternate MMU Vector 

Ch 0 0 0 0 

t< 0: 0 0 0 

2: 0 0 0 0 

3: 0 0 0 0 

4:0 0 

(output edited for brevity) 

%PC 0 %nPC 0 

%TBA 0 %CCR 0 XCC:nzvc ICC : nzvc 



0 0 



The prcLtding output shows that the registers are all empty, with vaiues 
of 0 (zero). Should the registers hold values other than 0, the probe 
command would most likely hang the system. 
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The probe- scsi Command 

The probe- scsi command identifies the peripheral devices attached to 
the on-board SCSI controller The probe- scsi command identifies such 
peripheral devices as disks, tape drives, or CD-ROMs by their target 
addresses. 

ok probe -scsi 

Target 1 

Unit 0 Disk FUJITSU MAB3045S SUN4 .2G17059825M62990 

Target 3 

Unit 0 Disk IBM DDRS34560SUN4 •2GS98E99255C5917 

(C) Copyright IBM Corp. 
1997, All rights reserved. 

Target 6 

Unit 0 Removable Read Only device SONY CDROM 

The probe-scsi-all Command 



The probe- scsi -all command identifies the peripheral devices that are 
attached to the on-board SCSI controller and all peripheral de% r ices 
attached to separate SBus or PCI SCSI controllers. 

ok probe- scsi -all 

/pci&lf , 0/pci@l/pci@l/SUNW, isptwo@4 
Target 3 

Unit 0 Disk FUJITSU MAB3045S SUN4.2G1907 
Target 4 

Unit 0 Removable Tape . EXABYTE EXB-8505SMBANSH20090 
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The probe- ide Command 



The probe -ide command identifies disks and CD-ROMs that are 
attached to the on -board IDE controller. This command displays the 
device number of the internal device. 



ok probe- ide 

Device 0 



( Primary Master ) 
ATA Model : ST 38 42 OA 



(DISK) 



Device 1 



Device 2 



{ Primary Slave ) 
Not Present 



( Secondary Master } 
Removable ATAPI Model : CRD- 8 32 2B (CD-ROM) 



Device 3 



( Secondary Slave ) 
Not Present 



The probe- f cal —all Command 

The probe- f cal -all OpenBoot PROM command identifies peripheral 
devices on systems containing the FC-AL GBICs, The Sim Enterprise™ 
35O0 server is an example of one of these systems. 



ok probe -f cal -all 

/pci@8, 6000GG/SUNW,qlc<a4 
Lie HA Port WWN 

10 10 2100002G37651bQe 

12 12 2100002037651cl2 
1 1 2100002037653317 

13 13 2100002037651f72' 

11 11 2100002037651f76 

14 14 2100002037651bf5 



Disk description 

SEAGATE ST318304FSUN18G 022D0017L007G2 

SEAGATE ST3183.04FSUN18G 022D0017L007VJ 

SEAGATE ST318304FSUN18G 032D0020L009TT 

SEAGATE ST318304FSUN18G 022D0017L007JZ 

SEAGATE ST318304FSUN18G 022D0017L007AL 

SEAGATE ST318304FSUN18G 022D0017L007XS 
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Identifying the System's Boot Device 



Sun hardware uses the concept of a device tree to organize devices that 
are attached to the system, 

Figure 8-6 shows the organizational structure of a device tree for an 
Ultra 5 or an Ultra 10 workstation. 



PROM monitor level (ok prompt) 





/ (root node level) 
Lpl pci@lf,0 
-T] pci@l 

HT] p^ 1 

5UNW, isptwoS*. 

-Q st@4,0 
- T*~l pci@l, 1 
ebus^X 
-T] ide@3 

— Q disk@0,0 
L-Q cdrofr^2,0 
— Q SUNW,m64B@2 

Figure 8-6 Partial Device Tree for an Ultra 5 or Ultra 10 Workstation 



Note - In Figure 8-6, some license has been token in naming these 
directories to simplify the illustration. 

The OpenBoot firmware builds the device tree from information gathered 
at the POST The device tree is loaded into memory and is used by the 
kernel diuing the boot process to identify all configured devices. 

The top of the device tree is the root device node. Following the root 
device node is a bus nexus node. Connected to a bus nexus node is a leaf 
node, typically a controller for an attached device, 
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In Figure 8-6, the disk@0 , 0 device is the IDE device for tine hard disk 
drive, and the cdrom@2 , 0 device is the IDE device for the CD-ROM drive. 
Both are attached to the IDE controller ide@3. Similarly, the sd<33 , 0 
device is the SCSI disk device and the st@4 , 0 device is the SCSI tape 
device. Both are attached to the PCI-based SCSI controller 
SUNW, isptwo©4. 

The paths built in the device tree by the Open Boot firmware vary 
depending on the type of system and its device configuration. 

Figure 8-7 shows a sample disk device path on an Ultra workstation with 
a PCI bus. 

/pci@lf , 0/pci(H, l/ide(a3/dad<a0, 0 



c 
c 



Root device node 



> 



Bus devices and controllers 



> 



^Device- vype (iDE ciiskj — - ^ 

^ IDE target address" ^ : 

^ Disk number (logical unit number or LUN) 



Figure 8-7 Disk Device Path - Ultra Workstation With a PCI IDE Bus 

Figure 8-8 shows a sample disk device path on an Ultra workstation with 
a PCI-SCSI bus. 



Root device node 



> 



Bus devices and controllers 



Device type (SCSI type) 



SCSI target address 



/pcieif^/pcitai/pciei/SUNW, isptwo£4/sd03, 0 

I I H ii n , iu 



> 



Disk number (logical unit nurooer or LUN) 



Figure 8-8 Disk Device Path - Ultra Workstation With a PCI-SCSI Bus 
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The show-devs Command 

You use the show-devs command to view the entire device tree. 
The following example shows output from the show-devs command. 

ok show-devs 

/SUNW,UltraSPARC-IIi@0, 0 
/pci@lf , 0 
/virtual -memory 
/memoryeO, 10000000 
/pci@lf , 0/pci@l 
/pci@lf , 0/pci@l, 1 
/pci@lf , 0/pciGl , l/ide@3 
/pci@lf , 0/pci(^,l/SUNW,m64B@2 
/pci@lf , 0/pci@l, 1 /network^ 1, 1 
'pciGlf , 0/pci@l, 1 ebus@l 
/pci@lf , 0/pci@l, l/ide@3/cdrom 
/pci£lf , 0/pci@l , l/ide@3 /disk 

/pci@lf , 0/pci@l f 1 /ebus£l/SUNW, CS4231£14 , 2 00000 

/pci@lf , 0/pci@l,l/ebus@l/flashprom@I0, 0 

/pci£lf , 0/pci@l,l/ebus@l/eeprom@14, 0 

/pciGlf, 07pci<51/pci@l 

/pci@lf , 0/pci@l/pci@l/SUNW, isptwo@4 

(output truncated) 

Note - In addition to the show-devs command, use the following 
additional Open Boot PROM commands to view specific device 
information; show- ttys, show- displays, show-nets, show- disks, and 
show- tapes. 
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The devalias Command 



To identify the current boot device alias for the system, use the devalias 
command, 



The following example shows output from the devalias command 

ok devalias 

screen /pcifclf , 0/pci@l , 1/SUMW, m64B@2 

net /pci@lf , 0/pci@l, l/network@l ( 1 

cdronn /pci@lf , G/pci@l, l/ide@3/cdrom@2 , 0 : f 

disk /pciGlf , 0/pci@l , l/ide@3/disk@0, 0 

disk3 /pciGlf , 0/pci@l, l/ideG3/disk@3 , 0 

disk2 /pciGlf ( 0/pcifcl, l/ide&3/disk(i2 , 0 

diskl /pci@lf , 0/pci@l r l/ide@3/cttsk#9%0 

diskO /pci@lf , 0/pci@l, l/ ide@3/disk@0 r 0 

ide /pciGlf ,0/pci£l, l/ide@3 

floppy /pci@lf , 0/pci@l, l/ebus£l/£dthree 

ttyb /pci@lf ,0/pciGl, l/ebus@I/se.;b 

ttya /pciGlf , 0/pci@l , 1 /efeusGl / se : a 

keyboard! /pci@lf , G/pci@l, l/ebus@l/su@14, 3083f 8 : forcemode 

keyboard /pciGlf , G/pci@l , l/ebus$l/su@14, 3083f 8 

mouse /pciGlf , 0/pciGl, 1 Zebus©! /su@14, 3062 f B 

name aliases 



Tlie left side of the command output list? the device alias names, and the 
righJ side of the output lists the physical address of each device. 

Device aliases are hard-coded into the OpenBoot PROM firmware, and 
they are easier to remember and use than the physical device addresses, 
The disk device alias identifies the default boot device for the system, 

The boot ^device parameter sets the system's boot device in the 
NVRAM. By default, the boot -device parameter is set to disk net. You 
can view the system's boot device through commands from the ok 
prompt. 

To boot the system from the default device, perform the boot command: 



ok boot 
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Creating and Removing Custom Device Aliases 

A portion of the NVRAM called NVRAMRC contains registers to hold 
custom parameters and is also reserved for storing new device alias 
names. External devices do not, by default have built-in device aliases 
associated with them, 

The NVRAMRC is affected by the commands nvaiias and nvunalias, as 
well as the parameter use^nvramrc?. 



The nvaiias Command 



You use the nvaiias command to create a new device alias name to 
access a newly attached external device. The command format is: 



nvaiias aliasname device_path 



The effect of the nvaiias command is to store the following command 



line in the NVRAMRC: 
devalias aliasname de vi ce_pa t/i 




The following example shows how to add a new boot device alias, called 
inydisk, and boot the system from this new boot device alias. 



Note - A shortcut provided with the show- disks command enables you 
to select a device and use the Control-Y keys to copy the device path onto 
the command line. 



The example uses the show-disks command to select the device path for 
the disk being used. It then uses the nvaiias command to create a new 
device alias called my disk. 

ok show-disks 

a) /pci@lf , 0/pci@l/scsi@l, 1/disk 

b) /pci&lf , 0/pci(21/scsi@l/disk 

c) /pciOlf , 0/pci@l, l/ide@3/cdrom 

d) /pci@lf , 0/pci@l, l/ide@3/disk 

e) /pciGlf , G/pci<21, l/ebus@l/fdthree@14, 3023f0 
q) NO SELECTION 

Enter Selection, q to quit: d 

/pci@lf , O/pci&l, l/ide@3/disk has been selected. 

Type "Y ( Control -Y) to insert it in the command line. 
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e.g. ok nvalias mydev A Y 

for creating devalias mydev for 
/pciGlf,0/pci@l,l/ide@3/disk 
ok nvalias mydisk A y 

To paste the device path for the selected disk, press Control -Y on the 
command line, 

ok nvalias mydisk /pci@lf , 0/pci<?l , l/ide@3 /disk£0 , 0 




Note - When the device path has been pasted on the command line (by 
the Control -Y keys), the target number and logical unit number (LUN) 
must be added for the disk device, for example, sd@0 , 0 or disk@Q , 0 . 



Set the boot -device parameter to the new value, in this case mydisk, 
and boot the system. 



ok setenv boot -device mydisk 

boot -device = mydisk 
ok boot 



The nvunalias Command 




You use the nvunalias command to remove an alias name. 



To remove a custom device alias name, use the following command 
format: 

ok nvunalias aliasn&me 



Note - The nvunalias command is the single exception to the rule that 
changes to NVRAM occur immediately and do not require a reset^all 
command. 



In the example, you would use the nvunalias command to delete the 
alias name mydisk from NVRAMRC and use the setenv command to set 
the boot -device parameter to disk, 

ok nvunalias mydisk 

ok setenv boot -device disk 

boot -device = disk 
ok reset-all 

Resetting . . . 
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Viewing and Changing NVRAM Parameters From the Shell 

Use the /usr / sbin / eepr om command to view and to change the 
NVRAM parameters while the Solaris OE is running. 



Using the eeprom Command 

Be aware of the following guidelines when using the eeprom command: 

• Only the root user can change the value of a parameter. 

• You must enclose parameters with a trailing question mark in single 
quotation marks (single quotes) when the command is executed in 
the C shell. 

• All changes are permanent- You cannot rim a reset command to 
undo the parameter changes. 

The following examples use the eeprom command to view and change 
NVRAM parameters. 

• To list all of the parameters with their current values, perform the 
command; 



t eeprom 



• To list a Single parameter and its value, in this case, the boot-device 
parameter, perform the command: 



# eeprom boot -device 

boo t - deviee^disk 
# 



• To change the value of the default boot device to disk2, perform the 
command: 



k eeprom boot-device=disk2 

# 



« To change the value of the auto-boot? parameter, perform the 
command: 



# eeprom auto-boot ? =true 

I 
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Interrupting an Unresponsive System 

When a system freezes or stops responding to the keyboard, you might 
have to interrupt it. When you interrupt the system, all active processes 
stop immediately, and the processor services the Open Boot PROM 
exclusively. It does not allow you to flush memory or to synchronize file 
systems. 

Aborting an Unresponsive System 

To abort or interrupt an unresponsive system: 

1. Attempt a remote login on the unresponsive system to locate and kill 
the offending process. 

2. Attempt to reboot the unresponsive system gracefully. 

3- Hoi Li down the Stop-A key sequence on the keyboard of the 
unresponsive system, The system is placed at the ok prompt. 




Note - If an ASCII terminal is being used as the system console, use the 
Break sequence keys. 

i Manually synchronize the file systems by using the Open Boot PROM 
sync command. 

ok sync 

This command causes the syncing of file systems, a crash dump of 
memory, and then a reboot of the system. 
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Performing the Exercises 

You have the option to complete any one of three versions of a lab. To 
decide which to choose, consult the following descriptions of the levels: 

• Level 1 - This version of the lab provides the least amount of 
guidance. Each bulleted paragraph provides a task description, but 
you must determine your own way of accomplishing each task- 

• Level 2 - This version of the lab provides more guidance. Although 
each step describes what you should do, you must determine the 
commands (and options) to input. 

• Level 3 - This version of the lab is the easiest to accomplish because 
each step provides exactly what you should input to the system. This 
level also includes the task solutions for all three levels. 
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Exercise: Using the OpenBoot PROM Commands 
(Level 1) 

In this exercise, you use the OpenBoot PROM and Solaris OE commands 
to perform the tasks described in this module. 

Preparation 

Refer to the lecture notes as necessary to perform the following tasks and 
answer the questions listed. 



Tasks 




Complete the following tasks: 

• Shut down the system to run level 0, and gather information about 
your system. Find out the following: 

• OpenBoot PROM revision 

• Megabytes of installed memory 

• System type 

• NVRAM serial number 

• Ethernet address 

• Host ID 

• Set the auto-boot? parameter to false. 
{Steps 1-11 in the Level 2 lab) 

• Create a new device alias called mydisk that uses the same device as 
the disk device alias. Verify the contents of the nvramrc file, and 
verify how to set the use-nvramrc? parameter. 

(Steps 12-17 in the Level 2 lab) 

• Boot the system using the new alias, As the root user, use the 
eeprom command to list all parameters. Set the boot -device 
parameter to the mydisk device alias. 

(Steps 18-22 in the Level 2 lab) 
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• Shut down the system to run level G, and verify the change you 

made by using the printenv command. Remove the mydisk device 
alias. Reset the boot-device parameter to its default value, and boot 
the system, 

(Steps 23-31 in the Level 2 lab) 
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Exercise: Using the OpenBoot PROM Commands 
(Level 2) 



In this exercise, you use the OpenBoot PROM and Solaris OE commands 
to perform the tasks described in this module. 



Refer to the lecture notes as necessary to perform the following tasks and 
answer the questions listed, 



In this exercise, you accomplish the following: 

• Shut down the system to run level 0, and use the following 

commands to set parameters and gather basic information about 
your system. 

banner 

set -de faults 

help 

help file 



probe-scsi-all 
probe- ide 

• Set the auto -boot? parameter to false. 

• Create a new device alias called mydisk that uses the same device as 
the disk device alias. Verify the contents of the nvramrc file, and 
verify how to set the use- nvramrc? parameter. 

• Boot the system using the new alias. As the root user, use the 
eeprom command to list all parameters. Set the boot -device 
parameter to the mydisk device alias. 

• Shut down the system to run level 0, and verify the change you 
made by using the printenv command. Remove the mydisk device 
alias. Reset the boot -device parameter to its default value, and boot 
the system. 



Preparation 



Task Summary 




printenv 
setenv 
reset-all 
probe-scsi 
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Tasks 



Complete the following steps: 

1. If the Solaris OE is currently ruriiung, log in as the root user, and 
halt your system. 

2. When the ok prompt appears, set the OpenBoot PROM parameters 
to their default values, 

3. Use the help command to display the list of help topics, 

4. Use the help command to display information about the boot 
command. 

What does the help command list for boot? 

5. Use the banner command to obtain the following information: 
OpenBoot PROM revision: 

Megabytes of installed memory; 

System type: 

NVRAM serial number: 

Ethernet address: 

Host ID: 

by Use the printenv command to display the list of OpenBoot PROM 
parameters. Record the current values for the following parameters: 

output-device "• 
inpu t - dev i ce 
auto -boot? 
boot-device 

7; Prevent the system from booting automatically after you use the 
reset-all command by setting the auto-boot? parameter to 
false. 

8. Use the reset -all command to verify that the new auto -boot? 
value is in effect, The system should remain at the ok prompt after 
the reset -all command completes. 

9. Use the probe- scsi, probe-scsi-all, and probe -ide commands 
to display the list of disk devices attached to your system. Not all of 
these commands are present on all systems. 

10. What are the main differences that you see in the Information that 
these commands display? 



Executing Boot PROM Commands 

Copyright 2003 Sun Microsystems, inc. All Rights Reserved. Sun Services, Revision A. 2 



8-33 



Exercise: Using the OpenBoot PROM Commands (Level 2) 



11, List the target number and device type (disk, tape, or CD-ROM) of 
all the devices shown by the probe- sc si, probe-scsi-a.ll, and 
probe ^xde commands. 

12, Verify that your default boot -device is set to disk net. 

13, Use the devalias command to display the full device path for the 
disk alias. 

Record the path name reported; 

14, Use the show -disks command to select the device path that relates 
to the disk recorded in Step 13, and use the nvalias command to 
create a new device alias called mydisk. Set the mydisk alias to the 
path and disk name you recorded in Step 13, 

Remember to use the Control -Y key sequence to paste the disk path 
into your nvalias command. You must manually complete the path 
to specify the disk you want to use. 

15, Verify that the new alias is correctly set. 

16« Use the printenv command to display the contents of the nvrarorc 
file. 

What command does the nvramrc file contain that creates the 
mydisk alias? 

17* Use the printenv command to display the setting of the 
use-nvramrc? parameter. 

What is the current setting of the use-nvramrc? parameter? 

18. Boot your system using the mydisk alias. 

19. Log in as the root user on your system. Open a new terminal 
window* 

20. Use the eeprom command to list all NVRAM parameters. 

21. Use the eeprom command to list the setting of the boot-device 
parameter. 

22. Use the eeprom command to set the boot -device parameter to the 
alias mydisk. 

23. Bring your system to run level 0. 

24. Verify that the eeprom command set the boot -device parameter to 
the alias mydisk, 

25. Set the boot-device parameter to its default value, and verify the 
setting, 

26. Use the nvunalias command to remove the alias mydisk. 
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27, Verify that the mydisk alias is no longer in the nvramrc file. 

28. Use the devalias command to see if the mydisk alias has been 
removed from the list of device aliases, 

Has it? 

29. Run the reset -all command, and then check again if the tirydisk 
alias has been removed from the list of device aliases. 

(If your system reboots, interrupt the reboot with a Sfrop-A key 
sequence.) 

Has it? 

30, Set the OpenBoot PROM parameters back to their default values, 
and boot the system from the default device. 



31 , Log in as the root user. 



: .... 
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Exercise: Using the OpenBoot PROM Commands 
(Level 3) 

In this exercise, you use the OpenBoot PROM and Solaris OE commands 
to perform the tasks described in this module, 

Preparation 

Refer to the lecture notes as necessary to perform the following tasks and 
answer the questions listed. 

Task Summary 

In this exercise, you accomplish the folio wing: 

• Shut down the system to run level G, and use the following 
commands to set parameters and gather basic information about 
your system. 

banner 
set-defaults 
help 

help file 
printenv 

Betenv 

... 

reset^all 
probe- scsi 
probe-scsi-all 
probe- ide 

• Set the auto-boot? parameter to false. 

• Create a new device alias called mydisk that uses the same device as 
the disk device alias. Verify the contents of the nvramrc file, and 
verify how to set the use-nvramrc? parameter. 

• Boot the system using the new alias. As the root user, use the 
eeprom command to list all parameters. Set the boot -device 
parameter to the mydisk device alias. 

• Shut down the system to run level 0, and verify the change you 
made by using the printenv command. Remove the mydisk device 
alias. Reset the boot-device parameter to its default value, and boot 
the system, 
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Tasks and Solutions 



Complete the following steps: 



1. 



# init 0 



ok set -defaults 

3. 

ok help 



ok help hoot 



ok print env 

output -device 
input -device 
auto-boot? 
boot -device 



If the Solaris OE is currently running, log in as the root user, and 
halt your system. 



When the ok prompt appears, set the OpenBoot PROM parameters 
to their default values. 



Use the help command to display the list of help topics. 



Use the help command to display information about the boot 
command. 



What does the help command list for boot? 

boot - Default boot (values specified in NVRAA1 variables), 

boot <network-device> : [tihep, ] [server- ip] , [boot- 
filename] , [client-ip] , [router-ip], [boot-retries], 
[tftp -retries] , [subnet -mask] , [boot -arguments] * 

Use the banner command to obtain the following information: 

OpenBoot I 1 ROM revision: 

Megabytes of installed memory: 

System type: 

NVRAM serial number: 

Ethernet address; 

Host ID: 

Each system presents its own unique information. 

Use the printenv command to display the list of OpenBoot PROM 
parameters. Record the current values for the following parameters: 

- screen 

- keyboard 

- true 

- disk net 
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7. Prevent the system from booting automatically after using the 
reset -all command by setting the auto- boor ? pelvimeter to 
false. 



ok setenv auto -boot? falsa 

8. Use the reset-all command to verify that the new auto-boot? 



value is in effect. The system should remain at the ok prompt after 
the reset-all command completes. 



9. Use the probe- scsi, probe- scsi-all, and probe- ide commands 
to display the list of disk devices attached to your system. Not all of 
these commands are present on all systems. 



10, What are the main differences that you see in the information that 
these commands display? 

The probe-scsi-all command lists all devices on all SCSI chains and 
their fall device paths. The probe- scsi command only lists devices on the 
first SCSI chain and does not list the full device patiis. The probe- ide 
command reports the list of IDE devices attached to the system* 

11. List the target number and de\ice type (disk, tape, or CD-ROM } of 
all the de v i ces sh own by the probe- s cs i t probe- scsi-all, and 
probe -ide commands. 

Each system presents its own unique information. 



12. Verify that your default boot -device is set to disk net. 
ok print env boot; -device 

13, Use the devalias command to display the full device path for the 
disk alias, 

devalias disk 



Record the path name reported: 

This differs from system to system. On an Ultra 5 workstation, the alias is 
defined as follows: 

/pci@lf 1 0/pci@l , l/ide@3 /disk@0 , 0 

l-L Use the s ho w~ disks command to select the device path that relates 
to the disk recorded in Step 13, and use the nvalias command to 
create a new device alias called my disk. Set the mydisk alias to tine 
path and disk name you recorded in Step 13, 



ok reset 



all 



ok probe 
ok probe 
ok probe 



scsi 

scsi -all 
ide 
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Remember to use the Control-Y key sequence to paste the disk path 
into your nvalias command. You must manually complete the path 
to specify the disk you want to use, 

ok shjow- disks 

(select one of the disks from the list) 
ok nvalias raydisk pathname^ f # 

15. Verify that the new alias is correctly set. 
ok devalias mydisk 

16. Use the print env command to display the contents of the nvramrc 
file. 

ok print env nvramrc 

What command does the nvramrc file contain that creates the 
mydisk alias? 

Systems differ according to the disk devices they use. An Ultra 5 
workstation would report the following: 

devalias mydisk /pci@lf , 0/pci@l/l/ide@3/disk@0 , 0 

17. Use the print env command to display the setting of the 
use-nvramrc? parameter. 

ok print env use -nvramrc? 

What is the current setting of the use-nvrararc? parameter? 
true 

IS. Boot your system using the mydi s k ali as. 

19, Log in as the root user on your system. Open a new terminal 
window. 

29* Use the eeprom command to list all NVRAM parameters. 

:■' : : : m> 

21. Use the eeprom command to list the setting of the boot -device 
parameter, 

| eeprom boot -device 

22. Use the eeprom command to set the boot -device parameter to the 
alias mydisk 

# eeprom boot-device=mydisk 

23. Bring your system to run level 0. 

* init 0 



ok boot inytiisk 
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24. Verify that the eeprom command set the boot-device parameter to 
the alias mydisk* 

ok print env boot-device 

25. Set the boot -device parameter to its default value, and verify the 
setting, 

ok: set -default boot -device 
;k printenv boot-device 

26. Use the nvunalias command to remove the alias nrydisk. 
ok mninalias mydisk 

27. Verify that the mydisk alias is no longer in the nvramrc file. 
..!■: printenv nvxamrc 

28. Use the devalias command to see if the mydisk alias has been 
removed from the list of device aliases. 

ok devalias mydisk 



Has it? 



No 



29. Run the reset-all command, and then check again if the mydisk 
alias has been removed from the list of device aliases. 



ok reset -all 



(If your system reboots, interrupt the reboot with a Stop-A key 
sequence.) 





Has it? 



3D 



Set the OpenBoot PROM parameters back to their default values, 
and boot the system from the default device. 



ok set -de faults 
oh reset -all 



Log in as the root user. 
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Exercise Summary 



Discussion - Take a few minutes to discuss what experiences, issues, < 
discoveries you had during the lab exercises, 

• Experiences 

• Interpretations 

• Conclusions 

• Applications 




Executing Boot PROM Commands 

Copyrighi 2003 Sun Microsystems. Inc. AH Rights Reserved. Sun Services. Revision A 2 



8-41 




Intermediate System 
Administration for the Solaris™ 9 
Operating Environment 
SA-239 

Revision A.2 

VOL I 




I OUC AT I ON A L SERVICES 1 ALES OFFICII 



Aftfi*NTIN*:^il Ill/** - AUlTJtAJJA: t teaiS*.* • Atttlt1*:4J 1 Wi AO ■ 8AHAHI: JUlEKllI * BQUUM: jj : W ft A] ■ SU£)L- W U UlTfim * MUNEI: b-WltAni - CANADA: t leoil}U/9 » CHIU: s£J fifK 
COLOMBA: WS&lLt] * tZICH REPUBLIC: 4.M < 3*«*lll ■ DENMARK: il Itfi VI* ■ ItTMj » JW J7>W ■ FINLAND?: isll^yjl • FRANCE. ill 41 'JVJM tilt MANY: *) * 4(44* J rtf * CflHtl: blllLftk 



L- s;m..«i;i;i • UKM REPUBLIC: 4M 1 5W«ni ■ DENMARK: ij yit ■ [CTPT: w w -U4J ■ FINLAND: r.« w=, •• . • r RAN-: : 
HONG KONCi SjMl.rJ f*fl • HUHGARV: *,uni 141: • INDIA: HtoJ***q • INDONESIA- fcSiHtljjJ - HE LAND: ft 3 1 «J J! ? ■ ISMEL: 
MALAYSIA: «e|JI]»!»; * MltWLI EAST AFRICA: 06 *7U JjfcjJJ ■ MUIW: S^TfcttyH ' fttlHttUWOfc * KEW fill) 

NORWAY-, ROM NORWAY; JJ nuffifl, TO NOWAY: IJJJJWOn > nUClSTAN:«04n* UWlJ ■ KOPtf'S RfPUfiUC OF CWNA: K>« U»j ' PWtlPW 
RUSSIA: i»q^!<.iiu • SAUDI ARABIA: OH q;u t£tjy ■ SINMPOAfc fcwjt t>i • SOUTH AFRICA: }MliS**W • J»»N: M*>- 
SW11ZI4LAND: V^10*V><r< fJfcMAhl (IJfrfKHH lUitVll) ■ TAIWAN: m->7i*Uf#, ■ 1HAI1AHD; G*HH«iS ■ TURRET; 96 IV JJS it ft * L 
YlNflUCLA: 5SJ WJ*C • WTNAM: ^ J WlJH * TORlTJWIDf. H£AO<ftJAKTEU: l (*>**l*» 



GERMANY-. *}»4<*«*JrM • GSfKI: KKHbUlLbi- 
ntWJ'V-fAPAfclli^^lAW WRfA: bJMSjtttu 

) W> M * NORTH WEST tfWCA; M i,']4 tftm 
*«ANO:4lJJ».'4 r >Mi'««TUCALj tfin<l)4»Oo 
5R3 LANUU t*llbfW * SWEDEN: <VU,Jt Jl » 
A|lj*4LtU* * UMttO JfKTIS: ll&OHoH 



We indlcs tin net work. 



SUN™ 



'^2002 Sua Wicwwwnw. Iw r AIL limits i«ervnl. Sun. the Sun logo, Sun Mtttowitm ,ini M Wf rnakf Uh> net wail." are trademarks or rtgisfrrrd ir&lfnwks of Sun Mitiosysterns. Ii 
Jiwtfd sui^ iiwffufwrcowitrtes. 



^ 



